hampsterx/claude-mcp-bridge

hampsterx/claude-mcp-bridge

от hampsterx
MCP-сервер, который оборачивает Claude Code CLI в подпроцесс и открывает его возможности как MCP-инструменты. Пригодится, если у клиента нет shell-доступа (Cursor, Windsurf, VS Code). Поддерживает ...

claude-mcp-bridge

npm version npm downloads CI License: MIT Node.js TypeScript MCP Available on CodeGuilds

MCP server that wraps Claude Code CLI as a subprocess, exposing its capabilities as Model Context Protocol tools.

Works with any MCP client: Codex CLI, Gemini CLI, Cursor, Windsurf, VS Code, or any tool that speaks MCP.

Do you need this?

If you're in a terminal agent (Codex CLI, Gemini CLI) with shell access, call Claude Code CLI directly:

# Analyze specific files
claude -p --bare --tools Read -- "Analyze src/utils/parse.ts for edge cases"

# With budget cap
claude -p --bare --max-budget-usd 0.50 "Is this retry logic sound?"

--bare skips hooks, memory, and plugins for clean subprocess use. --tools restricts which tools Claude can use at all; --allowed-tools only pre-approves permission and leaves everything else, including Bash, still reachable. --max-budget-usd prevents runaway costs.

--tools is variadic, so end the list with -- (or another flag) before the prompt. Without it the prompt is read as one more tool name and the CLI exits with "Input must be provided".

Инструменты были проиндексированы:
listSessionsтолько чтениеидемпотентный

Перечисляет активные сессии Claude CLI, отслеживаемые этим сервером. Возвращает метаданные сессии (ID, модели, тайминги, количество ходов, совокупную стоимость) для оркестрации. Используйте для проверки доступных сессий перед возобновлением с sessionId. Без затрат (только локальный поиск).

Список сессий

Параметры

Без параметров.

pingтолько чтениеидемпотентный

Health check: проверяет, установлен ли Claude CLI и выполнен ли вход, сообщает версии, возможности и конфигурацию. Без затрат (только локальная проверка).

Проверка работоспособности

Параметры

Без параметров.

queryвнешний мир

Выполняет запрос через Claude Code CLI с опциональным файловым контекстом и возобновлением сессии. Claude - это AI-агент для программирования, который умеет генерировать, анализировать, рефакторить и объяснять код. Возможности: генерация и рефакторинг кода, анализ и объяснение кода, понимание файлов (текст и изображения), многошаговые диалоги через sessionId. Стоимость: модель по умолчанию - Sonnet (~$0.01-0.10 за вызов). Используйте effort="low" для простых задач, effort="high" + model="opus" для сложного анализа. Установите maxBudgetUsd, чтобы ограничить стоимость одного вызова (рекомендуется для effort="max" или model="opus"). Советы: - Устанавливайте workingDirectory на целевой репозиторий, чтобы ответы учитывали проект. - Разбивайте сложные задачи на сфокусированные запросы, а не отправляйте один большой запрос. - Возобновляйте многошаговые диалоги с помощью sessionId из метаданных предыдущего ответа. - Включайте нужные файлы через параметр files для точного контекста (текстовые файлы подставляются в запрос, изображения включают режим allowed-tools). - Используйте noSessionPersistence=true для одноразовых вызовов без сохранения состояния.

Claude Query

Параметры
  • effortstring

    Уровень усилий: низкий, средний, высокий или максимальный (передаётся в --effort)

  • filesstring[]

    Пути к файлам (текстовым или графическим) относительно workingDirectory

  • maxBudgetUsdnumber

    Максимальный бюджет затрат в долларах США для этого вызова (передаётся в --max-budget-usd)

  • maxResponseLengthinteger

    Мягкий лимит на длину ответа в словах

  • modelstring

    Псевдоним модели или полное имя модели Claude

  • noSessionPersistenceboolean

    Отключает сохранение сеанса для эфемерных вызовов печати.

  • promptstringобязательный

    Промпт для отправки в Claude.

  • resetSessionboolean

    Очищает сохранённое состояние сеанса перед выполнением (используйте с sessionId, чтобы начать с чистого листа)

  • sessionIdstring

    Идентификатор сессии Claude для возобновления с помощью --resume.

  • timeoutnumber

    Таймаут в миллисекундах (по умолчанию: 60000, для запросов изображений: 120000)

  • workingDirectorystring

    Рабочий каталог для поиска файлов и выполнения команд CLI.

searchидемпотентныйвнешний мир

Веб-поиск через Claude Code CLI с помощью инструментов WebSearch и WebFetch. Ищет в интернете и составляет развёрнутый ответ с указанием источников. Используйте для: актуальной информации, поиска документации, справок по API, сравнения библиотек и исследовательских вопросов. Стоимость: Обычно ~$0.02–0.05 за поиск с Sonnet. Советы: - Задавайте конкретные, сфокусированные вопросы для лучших результатов. - Результаты включают URL источников для проверки. - Используйте maxResponseLength, чтобы управлять объёмом ответа. - Увеличьте тайм-аут для сложных исследовательских запросов, требующих множественных загрузок веб-страниц.

Веб-поиск

Параметры
  • effortstring

    Уровень усилий: low, medium, high или max (по умолчанию: medium для поиска)

  • maxBudgetUsdnumber

    Максимальный бюджет затрат в долларах США для этого вызова (передаётся в --max-budget-usd)

  • maxResponseLengthinteger

    Мягкий лимит на длину ответа в словах

  • modelstring

    Псевдоним модели или полное имя модели Claude

  • noSessionPersistenceboolean

    Отключает сохранение сеанса для эфемерных вызовов печати.

  • querystringобязательный

    Поисковый запрос или вопрос

  • sessionIdstring

    Идентификатор сессии Claude для возобновления с помощью --resume.

  • timeoutnumber

    Тайм-аут в миллисекундах

  • workingDirectorystring

    Рабочий каталог для CLI

structuredвнешний мир

Генерирует JSON, соответствующий предоставленной JSON Schema. Использует нативный флаг --json-schema в Claude CLI для валидированного вывода (не на стороне клиента). Используется для: извлечения данных из текста/файлов, классификации, разбора сущностей или любой задачи, требующей машиночитаемого вывода. Стоимость: как у обычного запроса (~$0.01-0.10 за вызов). Сложность схемы практически не влияет на стоимость. Советы: - Передавайте JSON Schema как JSON-строку в параметре schema. - Максимальный размер схемы: 20 КБ. Делайте схемы лаконичными для надёжного вывода. - Для задач извлечения данных включайте исходный текст через параметр files или прямо в запросе.

Структурированный вывод

Параметры
  • filesstring[]

    Пути к текстовым файлам для включения в контекст

  • maxBudgetUsdnumber

    Максимальный бюджет затрат в долларах США для этого вызова (передаётся в --max-budget-usd)

  • modelstring

    Псевдоним модели или полное имя модели Claude

  • noSessionPersistenceboolean

    Отключает сохранение сеанса для эфемерных вызовов печати.

  • promptstringобязательный

    Что генерировать или извлекать

  • schemastringобязательный

    JSON Schema в виде JSON-строки

  • sessionIdstring

    Идентификатор сессии Claude для возобновления с помощью --resume.

  • timeoutnumber

    Тайм-аут в миллисекундах (по умолчанию: 5000)

  • workingDirectorystring

    Рабочий каталог для поиска файлов и выполнения команд CLI.

0.7.2основная
0.7.1
0.7.0
0.6.1
0.6.0
0.5.1
0.5.0
0.4.1
0.4.0
0.3.1
0.3.0
0.2.0
0.1.0

Выберите клиент, чтобы установить hampsterx/claude-mcp-bridge:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "hampsterx-claude-mcp-bridge-u8uqyjrclz": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "hampsterx-claude-mcp-bridge-u8uqyjrclz": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "hampsterx-claude-mcp-bridge-u8uqyjrclz": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"hampsterx-claude-mcp-bridge-u8uqyjrclz\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"claude-mcp-bridge\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "hampsterx-claude-mcp-bridge-u8uqyjrclz": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add hampsterx-claude-mcp-bridge-u8uqyjrclz -- npx -y claude-mcp-bridge

Либо через JSON-конфиг:

claude mcp add-json hampsterx-claude-mcp-bridge-u8uqyjrclz "{\"command\":\"npx\",\"args\":[\"-y\",\"claude-mcp-bridge\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add hampsterx-claude-mcp-bridge-u8uqyjrclz -- npx -y claude-mcp-bridge

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.hampsterx-claude-mcp-bridge-u8uqyjrclz]
command = "npx"
args = ["-y", "claude-mcp-bridge"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите hampsterx/claude-mcp-bridge, а в поле команды запуска — строку ниже:
npx -y claude-mcp-bridge

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "hampsterx-claude-mcp-bridge-u8uqyjrclz": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "hampsterx-claude-mcp-bridge-u8uqyjrclz": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например hampsterx-claude-mcp-bridge-u8uqyjrclz.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: hampsterx-claude-mcp-bridge-u8uqyjrclz
    command: npx
    args:
      - "-y"
      - "claude-mcp-bridge"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "hampsterx-claude-mcp-bridge-u8uqyjrclz": {
      "command": "npx",
      "args": [
        "-y",
        "claude-mcp-bridge"
      ]
    }
  }
}

Похожие MCP-сервера

x51xxx/codex-mcp-tool

x51xxx/codex-mcp-tool

от x51xxx

MCP инструмент для интеграции Codex CLI с Claude и Cursor. Позволяет анализировать файлы через @-ссылки, вести многошаговые сессии в изолированном окружении и применять структурированные правки. Полезен разработчикам для безопасного рефакторинга.

TypeScript⭐ 24
aidemd-mcp/server

aidemd-mcp/server

от aidemd-mcp

MCP сервер для intent-driven разработки в AI-средах: управляет .aide spec-файлами, которые задают контекст для архитекторов, разработчиков и QA. Предоставляет инструменты для их создания, валидации...

TypeScript⭐ 4
optimaquantum/claude-critical-rules-mcp

optimaquantum/claude-critical-rules-mcp

от optimaquantum

MCP-сервер автоматически загружает 21 критическое правило в Claude AI, предотвращая типичные сбои. Основан на 96+ реальных случаях. Идеален для разработчиков и DevOps, желающих повысить надёжность ...

JavaScript⭐ 7
Savirinc/unfragile-mcp-server

Savirinc/unfragile-mcp-server

от savirinc

MCP сервер для поиска AI-артефактов и MCP-инструментов через граф соответствия Unfragile. Находит серверы по возможностям, собирает стеки, сравнивает альтернативы и выдает доверенные паспорта. Полезен разработчикам агентов в Claude, Cursor, Windsurf.

JavaScript⭐ 2
21st-dev/Magic-MCP

21st-dev/Magic-MCP

от 21st-dev

Создаёт готовые React-компоненты по текстовому описанию прямо в Cursor, Windsurf и VS Code. Подтягивает стили из 21st.dev и показывает превью на лету.

TypeScript⭐ 6127
askbudi/roundtable

askbudi/roundtable

от askbudi

Локальный MCP-сервер Roundtable AI делегирует задачи основного AI-ассистента специализированным моделям (Gemini, Claude, Codex, Cursor) для параллельного выполнения. Избавляет от копирования между ...

Python⭐ 126
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин