freemcplab / ディレクトリ / プレイグラウンド / codemcp

● コミュニティ 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と組み合わせて10倍の力を

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

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る