mcpd CLI
Демон mcpd запускает MCP-серверы из одного файла .mcpd.toml и отдает их агентам и скриптам как обычный HTTP API на локальном порту
- 193 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Запускает MCP-серверы подпроцессами с вашими переменными окружения и открывает их инструменты через HTTP на локальном порту
- Хранит секреты серверов в ~/.config/mcpd/ и подставляет их при запуске; права каждого сервера определяет сам сервер
Установка
- Работает в
Ручная установка
brew tap mozilla-ai/tapСначала добавляется тап Mozilla AI. Работает на macOS и Linux.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает MCP-серверы подпроцессами с вашими переменными окружения и открывает их инструменты через HTTP на локальном порту
- Хранит секреты серверов в ~/.config/mcpd/ и подставляет их при запуске; права каждого сервера определяет сам сервер
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcpd от Mozilla AI держит MCP-серверы в одном месте. В файле .mcpd.toml перечислены нужные серверы, их аргументы и переменные окружения, а демон запускает каждый сервер подпроцессом по stdio и проксирует запросы по HTTP. Приложению или агенту не нужно знать, на чем написан сервер: Python, JavaScript и Docker-образы выглядят как один API. Для начала хватает четырех команд. `mcpd init` создает проект и файл .mcpd.toml, `mcpd add time` добавляет сервер из реестра, `mcpd config args set` задает его аргументы, `mcpd daemon --dev` запускает демон. После этого инструмент сервера вызывается обычным POST-запросом на localhost:8090, а описание API лежит на /docs того же порта. Секреты остаются в ~/.config/mcpd/ и не попадают в файл проекта. Команда `mcpd config export` выгружает безопасный для репозитория снимок конфигурации: секреты заменены шаблонами, их удобно подставлять в CI и контейнерах. Тот же демон работает в Docker, поэтому локальная настройка переезжает на сервер без переписывания. Для IDE есть отдельный прокси mcpd-proxy: он показывает Cursor и VS Code все серверы mcpd через одно подключение.
Для кого. Командам, которые строят агентов на нескольких MCP-серверах и хотят одинаково запускать их на ноутбуке разработчика и в контейнерах на сервере.
Подходит, если
- Агенту нужны три MCP-сервера на Python, Node.js и в Docker, и вам не хочется поднимать их по отдельности
- Конфигурацию серверов надо хранить в git рядом с кодом, а ключи держать вне репозитория
- Приложение на любом языке должно вызывать инструменты MCP обычным HTTP-запросом без MCP-клиента
- Локальный набор серверов нужно перенести в CI или контейнер с подстановкой секретов
- В Cursor или VS Code нужны все серверы проекта через одну запись подключения
Не подходит, если
- Нужен один MCP-сервер для Claude Code: проще подключить его напрямую командой claude mcp add
- Требуется удаленный многопользовательский шлюз с OAuth и аудитом: mcpd запускает серверы и не заменяет такой шлюз
- На машине нет ни uv, ни Node.js, ни Docker, а серверам нужен один из них: без рантайма демон ничего не запустит
Пример запроса к агенту
Поставь mcpd, добавь сервер time, запусти демон в режиме разработки и вызови get_current_time для Варшавы через HTTPОграничения
- Демон запускает серверы только как подпроцессы по stdio. Пакеты должны начинаться с uvx::, npx:: или docker::, и под каждый префикс на машине нужен свой рантайм: uv, Node.js или Docker.
- Сборка из исходников требует Go версии 1.27.1 или новее. Готовый бинарник ставится через Homebrew на macOS и Linux или из релизов на GitHub.
- Пример из README слушает порт 8090 в режиме разработки. Доступ с других машин и защиту этого порта настраивайте сами, встроенной авторизации в README нет.
- Серверы из реестра Mozilla AI проходят свою проверку, а чужие пакеты проекту не принадлежат: их безопасность остается на вас.
Как отключить. Остановите процесс демона и удалите папку проекта с .mcpd.toml. Локальные секреты лежат в ~/.config/mcpd/, их можно удалить отдельно. Homebrew снимает пакет командой brew uninstall mcpd.
Частые вопросы
Что такое mcpd и чем он полезен команде?
mcpd — демон, который запускает MCP-серверы по описанию в файле .mcpd.toml и открывает их как HTTP API. Команда один раз описывает набор инструментов и получает одинаковую среду на ноутбуке и в контейнере.
Как поставить mcpd?
Выполните brew tap mozilla-ai/tap и brew install mcpd. Способ работает на macOS и Linux. Установка из релизов GitHub и сборка Go-бинарника описаны в документации docs.mozilla.ai/mcpd.
Нужен ли для mcpd Docker?
Только для серверов с префиксом docker:: и для запуска самого демона в контейнере. Серверам с префиксом uvx:: нужен uv, серверам с npx:: нужен Node.js.
Как вызвать инструмент MCP-сервера через mcpd?
Отправьте POST на адрес http://localhost:8090/api/v1/servers/<сервер>/tools/<инструмент> с JSON-телом аргументов. Полный список методов открывается на http://localhost:8090/docs.
Как подключить серверы mcpd к Cursor или VS Code?
Используйте mcpd-proxy, он запускается командой npx @mozilla-ai/mcpd-proxy. Прокси отдает IDE все серверы mcpd через одно MCP-подключение, настройка для Cursor и VS Code описана в документации по интеграции с IDE.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСамостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
Прокси между транспортами MCP: подключает stdio-клиентов к удаленным SSE и HTTP серверам и публикует локальные серверы по сети
Dokploy MCP
Dokploy MCP Server
Официальный MCP Dokploy открывает агенту 508 инструментов API: проекты, приложения, базы, Docker и резервные копии.
MCPM
mcpm
Менеджер пакетов и реестр MCP для всех платформ и клиентов: ищет, добавляет и настраивает MCP-серверы, запоминает источник и обновляет
Планировщик задач cronstable открывает агенту список заданий, историю запусков и разбор расписаний через MCP.
Менеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcpd (эта карточка) | да | 193 | ||
| Docker MCP Gateway | да | не нужна | 1 626 | шлюз Docker запускает серверы из каталога Docker в изолированных контейнерах, mcpd описывает любой набор серверов в .mcpd.toml |
| mcp-proxy | нет | не нужна | 2 814 | только мост между транспортами stdio, SSE и HTTP, без реестра серверов и управления секретами |
| MCP Gateway Registry | нет | OAuth | 1 038 | корпоративный шлюз с OAuth, аудитом и реестром, mcpd проще и рассчитан на команду и CI |
Коротко о README
В README после тезисов о декларативной конфигурации идут требования к рантаймам, установка через Homebrew и короткий пример с сервером time. Затем перечислены SDK для Python и JavaScript, SDK для плагинов на Go, .NET, Python и Rust, прокси для IDE и команды разработки проекта.