claude-mcp-bridge

claude-mcp-bridge

hampsterxMIT
2 звёзд
claude-mcp-bridge — это MCP-сервер, который запускает Claude Code CLI как подпроцесс и передаёт его функции по протоколу Model Context Protocol. Вы используете инструменты Claude: запросы по коду, поиск, анализ архитектуры, рефакторинг — прямо из своей среды разработки. Сервер пригодится, когда у клиента нет доступа к shell: например, в Cursor, Windsurf, VS Code или Claude Desktop. Вместо вызова claude -p --bare в терминале вы даёте команды AI-ассистенту в интерфейсе редактора. При этом сохраняются все возможности Claude Code CLI: ограничение инструментов (--allowed-tools), контроль бюджета (--max-budget-usd), возобновление сессий (--resume), структурированный вывод через --json-schema.
ClaudeDevelopmentSearch
Открыть на GitHub

Установка

npx -y claude-mcp-bridge

Характеристики

Общее

  • СтатусСообщество
  • Разработчикhampsterx
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Выполнение произвольных запросов к Claude Code CLI — задаёте промпт, сервер передаёт его в Claude и возвращает результат.
  • Поиск по кодовой базе — Claude ищет ошибки, уязвимости, нестандартные паттерны, анализирует код.
  • Структурированный ответ — указываете JSON-схему, сервер возвращает данные строго по схеме. Удобно для автоматической обработки.
  • Управление сессиями — сервер поддерживает несколько параллельных сессий. Можно начать диалог, прервать и продолжить, передав ID сессии.
  • Мониторинг бюджета — каждый ответ включает метрики стоимости. Вы контролируете расходы и устанавливаете лимит (--max-budget-usd).
  • Поддержка авторизации — работа по подписке (через claude login) или через API-ключ (ANTHROPIC_API_KEY).
  • Безопасность — можно ограничить, какие инструменты доступны Claude Code CLI, чтобы он не выполнял опасные операции.
  • Пинг и список сессий — инструменты для проверки соединения и просмотра активных диалогов.

Как подключить

  1. Установите Claude Code CLI и авторизуйтесь: claude login. Для работы через API-ключ задайте переменные ANTHROPIC_API_KEY и CLAUDE_BRIDGE_USE_API_KEY=1.
  2. Запустите сервер одной командой: npx -y claude-mcp-bridge.
  3. Настройте MCP-клиент. Для Claude Desktop добавьте в claude_desktop_config.json: { "mcpServers": { "claude-mcp-bridge": { "command": "npx", "args": ["-y", "claude-mcp-bridge"] } } } Для Cursor, Windsurf или VS Code укажите аналогичную конфигурацию в файлах .cursor/mcp.json, .windsurf/settings.json или .vscode/mcp.json соответственно.
  4. Перезапустите клиент, чтобы применить настройки.

Примеры запросов

  • Проверь код в файле src/api/login.ts на уязвимости и предложи исправления.
  • Найди все функции, которые используют устаревший метод `request`, и замени их на новый.
  • Создай OpenAPI спецификацию для модуля orders на основе существующих маршрутов.
  • Покажи стоимость последней сессии и общий расход API за сегодня.

Вы можете формулировать любые задачи, которые решает Claude Code CLI, — сервер передаёт их напрямую в инструмент.

Технические детали

  • Язык реализации: TypeScript (сборка в Node.js)
  • Транспорт: stdio
  • Лицензия: MIT
  • Зависимость: Node.js 18 и выше
  • Совместимые клиенты: любые MCP-клиенты — Cursor, Windsurf, VS Code, Claude Desktop, Codex CLI, Gemini CLI и другие

Поделиться