mcp-broker — MCP-сервер для Claude Code: что делает и как установить
Единый локальный шлюз перед внешними серверами протокола MCP. Экономит контекст сессии, подключая сторонние инструменты по требованию через поиск и вызов.
claude mcp add mcp-broker -- uvx mcp-brokerЧто делает mcp-broker
Демон работает через Unix-сокет, принимая запросы от клиентов через компактную stdio-прослойку. Вместо сотен определений инструментов агент видит всего пять служебных функций брокера: поиск, просмотр схемы, запуск, статус и закрытие сессии. Это убирает раздувание системного промпта. В тестах авторов число постоянно загруженных определений инструментов упало с 609 до 43.
Брокер запускает внешние процессы только при реальной необходимости и глушит зависшие задачи после выхода. Профили позволяют изолировать инструменты между сессиями или давать разным редакторам свои списки серверов. Мутирующие операции блокируются, пока их явно не разрешит список в YAML-конфиге. Все рабочие данные и логи сохраняются в $HOME/mcp/mcp-broker.
Какие задачи решает
- разгрузить контекст модели от сотен неиспользуемых инструментов
- предотвратить запуск дублирующих фоновых процессов в разных клиентах
- разграничить доступ к опасным мутирующим операциям через профили
- централизовать хранение состояния сессий и логов в одной директории
Примеры запросов агенту
- Найди через брокер инструмент для работы с базой данных Postgres.
- Покажи описание инструмента через
broker_describe_toolи статус подключённых серверов. - Вызови утилиту миграций через
broker_call_tool.
Как установить mcp-broker
Командой платформы
claude mcp add mcp-broker -- uvx mcp-brokeruvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-broker <команда>
Командой платформы
codex mcp add mcp-broker -- uvx mcp-brokeruvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-broker <команда>
Файл настроек
{
"mcpServers": {
"mcp-broker": {
"command": "uvx",
"args": [
"mcp-broker"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-broker <команда>
Файл настроек
{
"servers": {
"mcp-broker": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-broker"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-broker <команда>
Командой платформы
gemini mcp add mcp-broker uvx mcp-brokeruvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-broker <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-broker
Как установить mcp-broker в Claude Code?
Выполните команду claude mcp add mcp-broker -- uvx mcp-broker.
Что делает mcp-broker?
Он выступает локальным прокси-демоном между клиентами и внешними серверами протокола MCP. Брокер скрывает полный список инструментов за пятью служебными функциями и запускает нужные процессы по требованию.
Где mcp-broker хранит конфигурацию и рабочие данные?
Конфигурация задаётся в файле config/broker.private.yaml, а рабочие файлы, сокеты и логи записываются в каталог $HOME/mcp/mcp-broker.
