● 社群 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