claude-code-mcp

Проект claude-code-mcp

[0.1.3] - 2025-05-08

Измененный

• Повышенная безопасность за счет строгой проверки переменной среды CLAUDE_BIN . Теперь сервер проверяет путь, имя, существование и разрешения исполняемого файла перед использованием.

Зафиксированный

• Устранена потенциальная уязвимость внедрения команд, связанная с переменной среды CLAUDE_BIN .

Обзор

Проект claude-code-mcp представляет собой MCP-сервер для Claude Code.

Он вызывает локально установленную команду Claude Code и предоставляет следующие инструменты: explain_code , review_code , fix_code , edit_code , test_code , simulate_command и your_own_query . Сервер реализован с использованием Node.js и MCP SDK, получая запросы в формате JSON от клиентов через stdio. Внутри он использует кодировку Base64 для плавной обработки специальных символов (переходов на новую строку, кавычек и т. д.) в тексте на естественном языке, что обеспечивает повышенную стабильность и гибкость. Его основными ролями являются получение запросов, кодирование ввода, генерация и выполнение команд и возврат результатов выполнения в формате JSON. Было подтверждено, что этот проект работает в средах CLAUDE Code CLI (Ubuntu/WSL2 и т. д.).

💡 MCP Host с менее способным LLM может укротить и использовать силу Клода💪! С claude-code-mcp вы также можете вызывать Claude Code из Claude Desktop!! 😇😜😎 (неподтверждено)

Функции

Основные роли сервера:

• Прием запросов: прием запросов инструментов в формате JSON от клиентов (например, code , context , focus_areas и т. д.).
• Обработка входных данных: внутреннее кодирование Base64 полученного текста на естественном языке.
• Выбор инструмента и генерация команды: на основе имени инструмента в запросе соберите командную строку для запроса, используя фиксированный шаблон или свободный формат ( your_own_query ).
• Выполнение команды: используйте child_process.spawn Node.js для выполнения собранной команды и получения результата из стандартного вывода.
• Возврат результата: возврат результата выполнения клиенту в формате JSON.

Начиная

Предпосылки

• Node.js (рекомендуется >= v18, протестировано с v22.14.0)
• npm (или пряжа)
• Команда Claude Code установлена и аутентификация завершена. https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview

Установка и использование

Существует несколько способов использования claude-code-mcp :

1. Использование npx (рекомендуется для быстрого использования)

Вы можете запустить сервер напрямую без установки, используя npx :

2. Глобальная установка

Установите пакет глобально:

Затем вы можете запустить его как команду:

3. Локальная установка (для разработки)

Клонируйте репозиторий и установите зависимости:

Затем вы можете запустить созданный скрипт напрямую:

Конфигурация

Переменные среды:

Независимо от способа установки, вам необходимо настроить переменные среды. Создайте один из следующих файлов:

1. Использование настроек хоста MCP (рекомендуется для npx ): настройте переменные среды непосредственно в настройках хоста MCP (см. «Конфигурация хоста MCP» ниже). Это самый простой способ при использовании npx .
2. Использование файла .env : Создайте файл .env в каталоге, в котором вы запускаете команду npx @kunihiros/claude-code-mcp .
3. Использование глобального файла конфигурации: создайте файл .claude-code-mcp.env в вашем домашнем каталоге ( ~/.claude-code-mcp.env ).

При использовании файла ( .env или ~/.claude-code-mcp.env ) добавьте следующее содержимое, изменив путь CLAUDE_BIN :

Конфигурация хоста MCP (рекомендуется для npx ):

Добавьте следующее в настройки приложения MCP Host (например, настройки Claude Desktop). Этот метод позволяет вам напрямую устанавливать переменные среды.

(Может потребоваться перезапуск хост-приложения.)

Альтернативная конфигурация хоста MCP (глобальная установка / локальная разработка):

Если вы установили пакет глобально или запускаете его локально из клонированного репозитория, а команда claude-code-mcp находится в PATH вашей системы, вы можете использовать:

В этом случае необходимо настроить переменные среды с помощью файла .env или глобального файла ~/.claude-code-mcp.env как описано выше.

Подробности переменных среды

Этот сервер использует следующие переменные среды (задаются через настройки env хоста MCP, .env или ~/.claude-code-mcp.env ):

• CLAUDE_BIN : Указывает путь к исполняемому файлу CLI Claude. (Обязательно) Пример: /home/linuxbrew/.linuxbrew/bin/claude или C:\Users\YourUser\AppData\Local\bin\claude.exe
• LOG_LEVEL : Указывает уровень журнала. (Необязательно, по умолчанию info ). Возможные значения: debug , info , warn , error .

Доступные инструменты

Сервер claude-code-mcp предоставляет следующие инструменты:

• explain_code : Предоставляет подробное объяснение указанного кода.
• review_code : Проверяет указанный код.
• fix_code : Исправляет ошибки или проблемы в указанном коде.
• edit_code : Редактирует указанный код на основе инструкций.
• test_code : Генерирует тесты для указанного кода.
• simulate_command : Имитирует выполнение заданной команды.
• your_own_query : Отправляет пользовательский запрос с контекстом.

Примечание

• Расположение файла журнала ( claude-code-mcp.log ):
  • Попытки создать сначала в корне проекта.
  • Возвращается к домашнему каталогу пользователя ( ~/.claude-code-mcp.log ).
  • Наконец, возвращаемся к /tmp/claude-code-mcp.log .
• Ротация журналов пока не реализована (будьте осторожны с размером файла журнала).
• В первую очередь протестировано с Claude CLI на Ubuntu/WSL2.

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. ниже.

Отказ от ответственности

Это программное обеспечение предоставляется только для образовательных и исследовательских целей. Этот проект официально не связан с Anthropic и не одобрен Anthropic. Claude является торговой маркой Anthropic.

Проект использует Claude CLI как зависимость, но является независимым, поддерживаемым сообществом усилием. Пользователи должны убедиться, что они соблюдают условия обслуживания Anthropic при использовании этого проекта.

Разработчики данного проекта не несут ответственности за любое неправомерное использование программного обеспечения или нарушение условий обслуживания любых сторонних API или сервисов.