claude-mcp-bridge — MCP-сервер для Claude Code: установка
MCP-сервер запускает Claude Code CLI как набор инструментов для других MCP-клиентов. Нужен для запросов, поиска, структурированного JSON и продолжения сессий.
claude mcp add --env CLAUDE_CLI_PATH=<CLAUDE_CLI_PATH> --env CLAUDE_DEFAULT_MODEL=<CLAUDE_DEFAULT_MODEL> --env CLAUDE_QUERY_MODEL=<CLAUDE_QUERY_MODEL> --env CLAUDE_STRUCTURED_MODEL=<CLAUDE_STRUCTURED_MODEL> --env CLAUDE_SEARCH_MODEL=<CLAUDE_SEARCH_MODEL> --transport stdio claude-mcp-bridge -- npx -y claude-mcp-bridgeЧто делает claude-mcp-bridge
claude-mcp-bridge запускает Claude Code CLI как дочерний процесс и открывает его возможности через MCP. Сервер предоставляет инструменты query, search, structured, ping и listSessions: они работают с файлами, веб-поиском, JSON Schema, проверкой состояния и активными сессиями. В ответы добавляются сведения о модели, длительности, токенах и стоимости.
Для query доступны продолжение сессии, выбор уровня усилий, лимит бюджета и передача изображений. structured проверяет JSON по переданной схеме, а search возвращает синтезированный ответ с URL источников. Без установленного Claude Code CLI в PATH и авторизации сервер не запустится. Авторизация выполняется через claude login или через ANTHROPIC_API_KEY вместе с CLAUDE_BRIDGE_USE_API_KEY=1.
Сервер устанавливается через npx; параметры CLI и моделей задаются переменными окружения. Он рассчитан на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и другие указанные MCP-клиенты.
Какие задачи решает
- передать запрос Claude Code из MCP-клиента
- продолжить работу по идентификатору сессии
- получить JSON по заданной схеме
- выполнить веб-поиск через Claude CLI
- проверить авторизацию и состояние CLI
Примеры запросов агенту
- Проверь
src/utils/parse.tsна крайние случаи через инструментquery. - Сформируй ответ в JSON по этой схеме через
structured. - Найди актуальные источники по теме через
searchи верни ссылки.
Как установить claude-mcp-bridge
Командой платформы
claude mcp add --env CLAUDE_CLI_PATH=<CLAUDE_CLI_PATH> --env CLAUDE_DEFAULT_MODEL=<CLAUDE_DEFAULT_MODEL> --env CLAUDE_QUERY_MODEL=<CLAUDE_QUERY_MODEL> --env CLAUDE_STRUCTURED_MODEL=<CLAUDE_STRUCTURED_MODEL> --env CLAUDE_SEARCH_MODEL=<CLAUDE_SEARCH_MODEL> --transport stdio claude-mcp-bridge -- npx -y claude-mcp-bridgeВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Командой платформы
codex mcp add claude-mcp-bridge --env CLAUDE_CLI_PATH=<CLAUDE_CLI_PATH> --env CLAUDE_DEFAULT_MODEL=<CLAUDE_DEFAULT_MODEL> --env CLAUDE_QUERY_MODEL=<CLAUDE_QUERY_MODEL> --env CLAUDE_STRUCTURED_MODEL=<CLAUDE_STRUCTURED_MODEL> --env CLAUDE_SEARCH_MODEL=<CLAUDE_SEARCH_MODEL> -- npx -y claude-mcp-bridgeВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"claude-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"claude-mcp-bridge"
],
"env": {
"CLAUDE_CLI_PATH": "<CLAUDE_CLI_PATH>",
"CLAUDE_DEFAULT_MODEL": "<CLAUDE_DEFAULT_MODEL>",
"CLAUDE_QUERY_MODEL": "<CLAUDE_QUERY_MODEL>",
"CLAUDE_STRUCTURED_MODEL": "<CLAUDE_STRUCTURED_MODEL>",
"CLAUDE_SEARCH_MODEL": "<CLAUDE_SEARCH_MODEL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"claude-mcp-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"claude-mcp-bridge"
],
"env": {
"CLAUDE_CLI_PATH": "<CLAUDE_CLI_PATH>",
"CLAUDE_DEFAULT_MODEL": "<CLAUDE_DEFAULT_MODEL>",
"CLAUDE_QUERY_MODEL": "<CLAUDE_QUERY_MODEL>",
"CLAUDE_STRUCTURED_MODEL": "<CLAUDE_STRUCTURED_MODEL>",
"CLAUDE_SEARCH_MODEL": "<CLAUDE_SEARCH_MODEL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e CLAUDE_CLI_PATH=<CLAUDE_CLI_PATH> -e CLAUDE_DEFAULT_MODEL=<CLAUDE_DEFAULT_MODEL> -e CLAUDE_QUERY_MODEL=<CLAUDE_QUERY_MODEL> -e CLAUDE_STRUCTURED_MODEL=<CLAUDE_STRUCTURED_MODEL> -e CLAUDE_SEARCH_MODEL=<CLAUDE_SEARCH_MODEL> claude-mcp-bridge npx -y claude-mcp-bridgeВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о claude-mcp-bridge
Как установить claude-mcp-bridge в Claude Code?
Выполните claude mcp add claude-mcp-bridge -- npx -y claude-mcp-bridge.
Что делает claude-mcp-bridge?
Он оборачивает Claude Code CLI в MCP-сервер и предоставляет инструменты для запросов, веб-поиска, структурированного вывода, проверки состояния и списка сессий.
Что нужно для работы claude-mcp-bridge?
Нужны установленный Claude Code CLI в PATH и авторизация через claude login либо через ANTHROPIC_API_KEY с CLAUDE_BRIDGE_USE_API_KEY=1.
