Claude Code MCP Server

Клод Код MCP Сервер

Сервер MCP (Model Context Protocol), позволяющий запускать Claude Code в однократном режиме с автоматическим обходом разрешений.

Вы заметили, что Cursor иногда испытывает трудности со сложными, многошаговыми правками или операциями? Этот сервер с его мощным унифицированным инструментом claude_code стремится сделать Claude более прямым и способным агентом для ваших задач кодирования.

Обзор

Этот сервер MCP предоставляет один инструмент, который может использоваться LLM для взаимодействия с Claude Code. При интеграции с Claude Desktop или другими клиентами MCP он позволяет LLM:

• Запустить Claude Code с обходом всех разрешений (используя --dangerously-skip-permissions )
• Выполнять код Клода с любой подсказкой без прерываний на разрешение
• Прямой доступ к возможностям редактирования файлов
• Включить определенные инструменты по умолчанию

Преимущества

• У Claude/Windsurf часто возникают проблемы с редактированием файлов. У Claude Code это получается лучше и быстрее.
• Несколько команд могут быть поставлены в очередь вместо прямого выполнения. Это экономит контекстное пространство, поэтому более важные вещи сохраняются дольше, происходит меньше сжатий.
• Файловые операции, git или другие операции не требуют затратных моделей. Claude Code довольно экономически эффективен, если вы зарегистрируетесь в Antropic Max. Вы можете использовать Gemini или o3 в режиме Max и экономить средства, перекладывая задачи на более дешевые модели.
• У Клода более широкий доступ к системе, и он может делать то, что Курсор/Виндсерф не могут (или считают, что не могут), поэтому, когда они застревают, просто скажите им «использовать код Клода», и это обычно помогает им выйти из застоя.
• Агенты в правилах агентов.

Предпосылки

• Node.js v20 или более поздней версии (используйте fnm или nvm для установки)
• Claude CLI установлен локально (запустите его и вызовите /doctor) и -dangerously-skip-permissions принят.

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

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

• CLAUDE_CLI_NAME : Переопределить имя двоичного файла Claude CLI или указать абсолютный путь (по умолчанию: claude ). Это позволяет использовать пользовательский двоичный файл Claude CLI. Это полезно для:
  • Использование пользовательских оболочек Claude CLI
  • Тестирование с использованием фиктивных двоичных файлов
  • Запуск нескольких версий Claude CLI одновременно

  Поддерживаемые форматы:

  • Простое имя: CLAUDE_CLI_NAME=claude-custom или CLAUDE_CLI_NAME=claude-v2
  • Абсолютный путь: CLAUDE_CLI_NAME=/path/to/custom/claude

  Относительные пути (например, ./claude или ../claude ) не допускаются и приведут к ошибке.

  Если задано простое имя, сервер будет искать указанный двоичный файл в:

  1. Системный PATH (вместо команды claude по умолчанию)

  Примечание: путь установки локального пользователя ( ~/.claude/local/claude ) по-прежнему будет проверяться, но только для двоичного файла claude по умолчанию.

• MCP_CLAUDE_DEBUG : включить ведение журнала отладки (установите значение true для подробного вывода)

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

Рекомендуемый способ использования этого сервера — установка его с помощью npx .

Чтобы использовать пользовательское имя двоичного файла Claude CLI, вы можете указать переменную окружения:

Важная первоначальная настройка: принятие разрешений

Прежде чем сервер MCP сможет успешно использовать инструмент claude_code , необходимо сначала вручную запустить CLI Claude один раз с флагом --dangerously-skip-permissions , войти в систему и принять условия.

Это единоразовое требование Claude CLI.

Следуйте подсказкам, чтобы принять. После этого сервер MCP сможет использовать флаг неинтерактивно.

MacOS может запросить все виды разрешений для папок при первом запуске инструмента, и первый запуск затем не сработает. Последующие запуски будут работать.

Подключение к вашему MCP-клиенту

После настройки сервера вам необходимо настроить ваш клиент MCP (например, Cursor или другие, использующие mcp.json или mcp_config.json ).

Файл конфигурации MCP

Конфигурация обычно выполняется в файле JSON. Имя и местоположение могут различаться в зависимости от вашего клиента.

Курсор

Курсор использует mcp.json .

• macOS: ~/.cursor/mcp.json
• Windows: %APPDATA%\\Cursor\\mcp.json
• Linux: ~/.config/cursor/mcp.json

Виндсерфинг

Пользователи Windsurf используют mcp_config.json

• macOS: ~/.codeium/windsurf/mcp_config.json
• Windows: %APPDATA%\\Codeium\\windsurf\\mcp_config.json
• Linux: ~/.config/.codeium/windsurf/mcp_config.json

(Примечание: в некоторых смешанных установках, если также установлен Cursor, эти клиенты могут вернуться к использованию пути Cursor ~/.cursor/mcp.json . Отдайте приоритет специфичным для Codeium путям, если используете расширение Codeium.)

Создайте этот файл, если он не существует. Добавьте или обновите конфигурацию для claude_code :

Предоставляемые инструменты

Этот сервер предоставляет один основной инструмент:

claude_code

Выполняет запрос напрямую с помощью Claude Code CLI с --dangerously-skip-permissions .

Аргументы:

• prompt (строка, обязательно): Подсказка для отправки Клоду Коду.
• options (объект, необязательно):
  • tools (массив строк, необязательно): Конкретные инструменты Claude для включения (например, Bash , Read , Write ). Общие инструменты включены по умолчанию.

Пример запроса MCP:

Примеры

Вот несколько наглядных примеров работы сервера:

Исправление настройки ESLint

Вот пример использования инструмента Claude Code MCP для интерактивного исправления настройки ESLint путем удаления старых файлов конфигурации и создания новых:

Пример листинга файлов

Вот пример инструмента Claude Code, выводящего список файлов в каталоге:

Основные варианты использования

Этот сервер, через свой унифицированный инструмент claude_code , открывает широкий спектр мощных возможностей, предоставляя вашему ИИ прямой доступ к Claude Code CLI. Вот несколько примеров того, чего вы можете достичь:

1. Генерация кода, анализ и рефакторинг:
   • "Generate a Python script to parse CSV data and output JSON."
   • "Analyze my_script.py for potential bugs and suggest improvements."
2. Операции с файловой системой (создание, чтение, редактирование, управление):
   • Создание файлов: "Your work folder is /Users/steipete/my_project\n\nCreate a new file named 'config.yml' in the 'app/settings' directory with the following content:\nport: 8080\ndatabase: main_db"
   • Редактирование файлов: "Your work folder is /Users/steipete/my_project\n\nEdit file 'public/css/style.css': Add a new CSS rule at the end to make all 'h2' elements have a 'color: navy'."
   • Перемещение/Копирование/Удаление: "Your work folder is /Users/steipete/my_project\n\nMove the file 'report.docx' from the 'drafts' folder to the 'final_reports' folder and rename it to 'Q1_Report_Final.docx'."
3. Контроль версий (Git):
   • "Your work folder is /Users/steipete/my_project\n\n1. Stage the file 'src/main.java'.\n2. Commit the changes with the message 'feat: Implement user authentication'.\n3. Push the commit to the 'develop' branch on origin."
4. Выполнение команд терминала:
   • "Your work folder is /Users/steipete/my_project/frontend\n\nRun the command 'npm run build'."
   • "Open the URL https://developer.mozilla.org in my default web browser."
5. Поиск в Интернете и обобщение:
   • "Search the web for 'benefits of server-side rendering' and provide a concise summary."
6. Сложные многоэтапные рабочие процессы:
   • Автоматизируйте повышение версии, обновление журналов изменений и выпуски тегов: "Your work folder is /Users/steipete/my_project\n\nFollow these steps: 1. Update the version in package.json to 2.5.0. 2. Add a new section to CHANGELOG.md for version 2.5.0 with the heading '### Added' and list 'New feature X'. 3. Stage package.json and CHANGELOG.md. 4. Commit with message 'release: version 2.5.0'. 5. Push the commit. 6. Create and push a git tag v2.5.0."
7. Исправление файлов с синтаксическими ошибками:
   • "Your work folder is /path/to/project\n\nThe file 'src/utils/parser.js' has syntax errors after a recent complex edit that broke its structure. Please analyze it, identify the syntax errors, and correct the file to make it valid JavaScript again, ensuring the original logic is preserved as much as possible."
8. Взаимодействие с GitHub (например, создание запроса на извлечение):
   • "Your work folder is /Users/steipete/my_project\n\nCreate a GitHub Pull Request in the repository 'owner/repo' from the 'feature-branch' to the 'main' branch. Title: 'feat: Implement new login flow'. Body: 'This PR adds a new and improved login experience for users.'"
9. Взаимодействие с GitHub (например, проверка статуса PR CI):
   • "Your work folder is /Users/steipete/my_project\n\nCheck the status of CI checks for Pull Request #42 in the GitHub repository 'owner/repo'. Report if they have passed, failed, or are still running."

Исправление рабочего процесса действий GitHub

Сложные многоэтапные операции

В этом примере показано, как claude_code обрабатывает более сложную многошаговую задачу, например, подготовку релиза путем создания ветки, обновления нескольких файлов ( package.json , CHANGELOG.md ), внесения изменений и инициирования запроса на извлечение — все это в рамках одной последовательной операции.

ВАЖНО: Не забудьте указать контекст текущего рабочего каталога (CWD) в ваших запросах для операций файловой системы или git (например, "Your work folder is /path/to/project\n\n...your command..." ).

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

• "Команда не найдена" (claude-code-mcp): Если установлено глобально, убедитесь, что глобальный каталог bin npm находится в системной переменной PATH. Если используется npx , убедитесь, что сам npx работает.
• "Команда не найдена" (claude или ~/.claude/local/claude): Убедитесь, что Claude CLI установлен правильно. Запустите claude/doctor или проверьте его документацию.
• Проблемы с разрешениями: убедитесь, что вы выполнили шаг «Важный шаг первоначальной настройки».
• Ошибки JSON с сервера: если MCP_CLAUDE_DEBUG имеет true , сообщения об ошибках или журналы могут помешать анализу JSON MCP. Установите значение false для нормальной работы.
• Ошибки ESM/импорта: убедитесь, что вы используете Node.js v20 или более позднюю версию.

Для разработчиков: локальная настройка и вклад

Если вы хотите разработать этот сервер или внести в него свой вклад, или запустить его из клонированного репозитория для тестирования, ознакомьтесь с нашим Руководством по локальной установке и настройке разработки .

Тестирование

Проект включает в себя комплексные тестовые наборы:

Подробную документацию по тестированию см. в нашем Руководстве по тестированию E2E .

Конфигурация через переменные среды

Поведение сервера можно настроить с помощью следующих переменных среды:

• CLAUDE_CLI_PATH : Абсолютный путь к исполняемому файлу Claude CLI.
  • По умолчанию: проверяет ~/.claude/local/claude , затем возвращается к claude (ожидая его в PATH).
• MCP_CLAUDE_DEBUG : Установите значение true для подробного ведения журнала отладки с этого сервера MCP. По умолчанию: false .

Их можно задать в среде оболочки или в блоке env конфигурации сервера mcp.json (хотя блок env в примерах mcp.json был удален для простоты, при необходимости его все еще можно задать для процесса сервера).

Внося вклад

Вклады приветствуются! Пожалуйста, обратитесь к Руководству по локальной установке и настройке разработки для получения подробной информации о настройке вашей среды.

Отправляйте проблемы и запросы на извлечение в репозиторий GitHub .

Лицензия

Массачусетский технологический институт