codemcp: ассистент кодирования MCP для Claude Desktop

Общее введение

codemcp - это инструмент с открытым исходным кодом, предназначенный для Клод Пользовательский дизайн рабочего стола, разработанный Эдвардом З. Янгом на GitHub. Это делает Claude Desktop полезным помощником в парном программировании. Пользователи могут попросить Клода реализовать функции, исправить ошибки или провести рефакторинг в их локальной кодовой базе прямо через диалог, без необходимости вручную копировать и вставлять код. поддержка codemcp Антропология Услуга подписки Claude Pro (20 долларов в месяц) позволяет избежать высокой платы за API. Он обеспечивает безопасную и контролируемую работу искусственного интеллекта, ограничивая набор инструментов и обеспечивая использование контроля версий Git. Разработчики могут проверять и корректировать код с помощью своих любимых IDE для различных сценариев программирования.

Список функций

• Прямое редактирование локального кода: Измените файл проекта через Claude, чтобы автоматически сохранить изменения.
• Выполнение тестов и форматирование: Выполнение тестовых сценариев и команд форматирования для поддержания качества кода.
• Управление коммитами Git: Генерируйте Git-коммиты для каждого изменения, с поддержкой просмотра и отката.
• Поддержка конфигурации проекта: Инициализируйте проект с помощью файла конфигурации для загрузки пользовательских команд.
• Отслеживание журналов: Записывайте детали работы для облегчения поиска и устранения неисправностей.

Использование помощи

Процесс установки

Чтобы использовать codemcp, вам необходимо установить зависимости и настроить среду. Ниже приведены подробные шаги:

1. Установка инструмента uv
   Для работы codemcp используется uv. Сначала установите uv, мы рекомендуем использовать официальный скрипт установки:
   • Linux/MacOS:

     curl -LsSf https://astral.sh/uv/install.sh | sh
     

   • Windows (PowerShell):

     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
     

   После установки запустите uv --version Проверьте версию, чтобы убедиться, что установка прошла успешно.

2. Настройка рабочего стола Claude
   Открыть или создать claude_desktop_config.json добавьте следующее:

{
"mcpServers": {
"codemcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/ezyang/codemcp@prod",
"codemcp"
]
}
}
}

После сохранения Claude Desktop загрузит codemcp с GitHub через uvx.

3. Настройка профиля проекта
   В корне вашего Git-репозитория создайте файл codemcp.toml Документация. Пример:

format = ["./run_format.sh"]
test = ["./run_test.sh"]

• format: Указывает путь к скрипту форматирования для нормализации кода.
• test: Укажите путь к тестовому сценарию для запуска теста.
  Эти сценарии необходимо написать самостоятельно, чтобы обеспечить корректную активацию и работу виртуальной среды.

Как использовать

После завершения установки вы можете работать с codemcp в Claude Desktop. Вот точная процедура:

1. проект инициализации

Создайте новый проект в Claude Desktop и введите его в Project Instructions:

Before doing anything, first init project $PROJECT_DIR.

главнокомандующий (военный) $PROJECT_DIR Замените его на путь к вашему проекту, например /Users/username/myproject. После инициализации codemcp прочитает файл codemcp.toml Конфигурация.

2. Изменение кодов через диалог

В окне чата Claude Desktop прямо скажите Клоду, что вы хотите изменить. Пример:

• "Добавьте в main.py функцию, которая вычисляет ряд Фибоначчи".
• "Исправьте логическую ошибку в utils.py".
  Клод будет редактировать файл через codemcp и автоматически генерировать Git-коммит после каждого изменения. Это можно сделать с помощью git log Просмотр истории отправки.

3. проверка и управление изменениями кода

Рекомендуется выделить отдельную ветку (например. develop), чтобы запустить codemcp с веткой по умолчанию, установленной на mainНиже перечислены общие команды Git. Ниже перечислены общие команды Git:

• Посмотреть изменения::git diff main Отображает отличие от основной ветви.
• Принятие изменений::git fetch . develop:main Слияние изменений с основной веткой.
  • Сохранение истории подачи: первая git checkout mainснова git merge develop --no-ff.
  • Представление сжатия: Выполнить git rebase -iЕсли вы не уверены в том, что хотите сделать, выберите squash, а затем выполните fetch.
• Отмена изменений::git reset --keep main Возврат к состоянию главной ветви.

4. Тестирование и форматирование реализации

Если вы настроите test ответить пением formatВы можете попросить Claude выполнить эти команды. Например:

• "Выполните все тесты и проверьте, что код работает".
• "Форматирование кода после завершения миссии".
  Тесты выполняются на полпути выполнения задания, а форматирование производится в конце задания.

5. Обработка ограничения расхода

Claude Pro имеет ограничение по времени, и Claude приостанавливает работу, когда сталкивается с ограничением потока. Вы можете использовать это время:

• Проверьте сгенерированный код.
• Планирование следующих задач.
  Как только ограничение будет снято, просто продолжайте диалог.

6. просмотр журнала

Если у вас возникли проблемы, проверьте ~/.codemcp/codemcp.log Файл журнала. Для более подробного ведения журнала отредактируйте ~/.codemcprc::

[logger]
verbosity = "DEBUG"

Поддерживаются следующие уровни: DEBUG, INFO, WARNING, ERROR и CRITICAL.

Функциональное управление

• конструкция безопасности: codemcp ограничивает область применения инструментов Клода, чтобы избежать злоупотреблений. Все изменения откатываются через Git.
• Совместимость с IDEИзменения в коде можно просматривать и корректировать с помощью любой IDE (например, VS Code).
• ручное управление: Неавтоматизированные агенты, каждая задача должна быть проверена и продолжена пользователем, чтобы убедиться, что код движется в правильном направлении.

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