● 社区 ezyang ⚡ 即开即用

codemcp

Name: codemcp MCP Server
Author: ezyang

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.

▶ 观看演示 📦 安装 💡 使用场景

为什么要用

核心特性

Tiny surface area: ReadFile, WriteFile, EditFile, RunCommand, InitProject
Project-scoped config in codemcp.toml per repo — defines allowed commands
Auto-commit per change so you always have a git checkpoint
Single-file install via uvx codemcp
Claude Desktop becomes a real IDE-replacement for free-tier coding

实时演示

实际使用效果

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 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "codemcp": {
      "command": "uvx",
      "args": [
        "codemcp"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "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 使用服务器对象数组，而非映射。

~/.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

步骤

Init a project

Initialize codemcp in /repos/my-project. Whitelist pytest and ruff only.✓ 已复制

→ codemcp.toml written with those two commands
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 搭配，撬动十倍杠杆

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
每次调用 Token 数: 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 Code	You're on Claude Max and want first-party integration	Paid; codemcp is free + open source

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills