/ Каталог / Песочница / codemcp
● Сообщество ezyang ⚡ Сразу

codemcp

автор ezyang · ezyang/codemcp

Minimal MCP coding agent for Claude Desktop — read/write/run, nothing else.

codemcp turns Claude Desktop into a usable coding agent without paying for Claude Code. It exposes just enough to be productive: a file reader/writer, a shell runner, and a project init step. Designed to be small, auditable, and easy to bring your own restrictions.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

codemcp.replay ▶ готово
0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "codemcp": {
      "command": "uvx",
      "args": [
        "codemcp"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "codemcp": {
      "command": "uvx",
      "args": [
        "codemcp"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "codemcp": {
      "command": "uvx",
      "args": [
        "codemcp"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "codemcp": {
      "command": "uvx",
      "args": [
        "codemcp"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "codemcp",
      "command": "uvx",
      "args": [
        "codemcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "codemcp": {
      "command": {
        "path": "uvx",
        "args": [
          "codemcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add codemcp -- uvx codemcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: codemcp

Use Claude Desktop as a free Claude Code replacement

👤 Devs on Claude Pro (not Max) who want agentic coding ⏱ ~15 min intermediate

Когда использовать: You don't want to pay for Claude Code but want the same loop in Desktop.

Предварительные требования
  • Server/skill installed and authenticated — See repo README
Поток
  1. Init a project
    Initialize codemcp in /repos/my-project. Whitelist pytest and ruff only.✓ Скопировано
    → codemcp.toml written with those two commands
  2. Iterate
    Add a /healthz endpoint and a test for it. Run pytest after.✓ Скопировано
    → File edits + green test output, auto-committed

Итог: Coding-agent workflow in plain Claude Desktop — every step a git commit.

Подводные камни
  • RunCommand only runs what's whitelisted in codemcp.toml — RunCommand only runs what's whitelisted in codemcp.toml — list every command you'll need upfront.
Сочетать с: github · filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

codemcp + github

Pair with github for complementary capabilities

Use this server together with github to complete a multi-step task.✓ Скопировано
codemcp + filesystem

Pair with filesystem for complementary capabilities

Use this server together with filesystem to complete a multi-step task.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
ReadFile path: str Inspect code before editing free
EditFile path, old, new Make a surgical change free
RunCommand command: str Run tests or scripts whitelisted in codemcp.toml free

Стоимость и лимиты

Во что обходится

Квота API
See provider docs for rate limits
Токенов на вызов
Varies by tool
Деньги
See repo README for pricing details
Совет
Cache tool results and avoid repeated identical calls.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Use environment variables; never commit secrets
Исходящий трафик: Tool calls go to the provider's API as documented

Устранение неполадок

Частые ошибки и исправления

command not in allowlist

Add the command to codemcp.toml under [commands] before asking Claude to run it.

Проверить: cat codemcp.toml
edit didn't match

EditFile uses exact match. Read the file first and copy the exact old string including whitespace.

Проверить: ReadFile and compare

Альтернативы

codemcp в сравнении

АльтернативаКогда использоватьКомпромисс
Claude CodeYou're on Claude Max and want first-party integrationPaid; codemcp is free + open source

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills