Deskaid

コードmcp

codemcp をインストールすれば、Claude Desktop をペアプログラミングアシスタントとして使えます。codemcp を使えば、Claude にあなたのコンピュータ上のコードベースで機能の実装、バグ修正、リファクタリングを直接依頼できます。Claude は直接ファイルを編集し、テストを実行します。Claude のチャットウィンドウにコードをコピーしたりコピーしたりする必要はもうありません！

codemcp は他の AI コーディング ソフトウェア (Claude Code、Cursor、Cline、Aider) と同様の機能を提供しますが、設計空間において独自の位置を占めています。

1. これは、Anthropicの月額20ドルのサブスクリプションサービスであるClaude Proと併用することを目的としています。サブスクリプションプランで使用量を支払うのは、エージェントのアクションにかかる限界費用がゼロになるので気に入っています。機能しない変更セットに5ドルも無駄にしたと後悔する必要がなくなります。Claude Max（月額100ドル）をお持ちの場合は、Claude Codeもサブスクリプション制でご利用いただけます。この場合、codemcpの価値提案はより曖昧です（そして、いくつかの点ではClaude Codeより明らかに劣っています）。しかし、Claude Maxの他のUI設定が好みであれば、codemcpをClaude Maxと併用することも可能です。（また、Claude Codeとは異なり、オープンソースなので、気に入らない場合は変更可能です！）
2. デフォルトで自動承認されるように設計されています。エージェントが私の監視なしで可能な限り作業を進められるようにし、最後にすべてを一度にレビューできるようにしたいと考えています。codemcp が他の多くのコーディングエージェントと異なる点は2つあります。無制限のシェルを禁止し、代わりにエージェントが使用できるコマンドをcodemcp.tomlで事前に宣言することを義務付けていることと、 LLM のすべての編集内容を Git バージョン管理していることです。これにより、エージェントの変更をきめ細かくロールバックでき、変更のコミット忘れを心配する必要がなくなります。
3. IDEに依存しません。Claudeに変更を依頼すると、Claudeが変更を適用し、その後はお好みのIDE設定で変更内容を確認してさらに編集できます。私は普段使いのエディタとしてvimを使っていますが、VSCodeや特定のエディタを必要とするコーディング環境は私には魅力的ではありません。

重要: マスターユーザー向け - トークン効率に関する大きな変更

codemcpのトークン効率を向上させるため、マスターサーバー上でcodemcpをマルチツールツール（InitProject実行時にチャットで指示が送信される単一のツールではなく）に戻す作業を進めています。つまり、ツールの使用を手動で承認する必要があります。ツールの使用承認は複数のチャットにまたがって永続的に行われるため、これは妥当なトレードオフだと思いますが、どうしても気に入らない場合は、ツール使用の自動承認をサポートするブラウザ拡張機能refined-claudeにバグ報告を行ってください。

インストール

codemcp をインストールして使用するには、次の特定の方法をお勧めします。

1. まだインストールされていない場合は、 uvと git をインストールします。
2. ブラウザにclaude-mcpをインストールしてください。これにより、ウェブサイトからSSE MCPサーバーに直接接続できるようになります。つまり、Claude Desktopを使用する必要がなくなり、複数のチャットウィンドウを簡単に並行して表示できるようになります。この拡張機能は、 Integrationsのロールアウトによりまもなく廃止される予定です。ただし、本稿執筆時点では、Claude Proサブスクリプションのお客様にはIntegrationsはまだ提供されていません。
3. uvx --from git+https://github.com/ezyang/codemcp@prod codemcp serveを使用して codemcp を実行します。非標準ポートで listen する必要がある場合は、 --port 1234追加できます。プロのヒント：危険を冒してでもやりたいなら、 prodをmainに変更することもできます。特定のリリースに固定したい場合は、 0.3.0などに置き換えてください。プロのヒント: codemcp はリモートから実行できます。Tailscale を使用しており、Tailnet 上のすべてのデバイスを信頼している場合は、 --host 100.101.102.103渡すことで安全に実行できます (IP をノードの Tailscale IP アドレスに置き換えます。この IP は通常 100.64.0.0/10 の範囲にあります)。警告:この MCP にアクセスできるユーザーは誰でもコンピューター上で任意のコードを実行できるため、0.0.0.0 にバインドすることはほとんど考えられません。
4. claude-mcp を URL で設定します: http://127.0.0.1:8000/sse (必要に応じてポートを置き換えます)。
5. 残念ながら、Web UI にはハンマーアイコンが常に表示されます。ただし、コンソールで「[MCP codemcp] SSE 接続が開かれました」と表示されるか、Claude に利用可能なツールを確認することで、MCP サーバーが動作していることを確認できます（codemcp のツールが利用可能であると表示されるはずです）。

Claude Desktop を使用したい場合、または特殊なニーズがある場合は、さまざまな非標準の状況に対応したインストール手順についてはINSTALL.md を参照してください。

使用法

まず、作業対象のGitリポジトリのチェックアウトにcodemcp.tomlファイルを作成する必要があります。エージェントにフォーマッタの実行やテストの実行などを実行させたい場合は、コマンドセクションに実行コマンドを追加します（注：これらのコマンドは、必要な仮想環境を適切に設定する必要があります）。

formatコマンドは特別で、ファイルの編集後に必ず実行されます。

次に、Claude Desktop でプロジェクトを作成し、これをプロジェクトの指示に含めることをお勧めします。

ここで、 $PROJECT_DIR作業するプロジェクトへのパスです。

その後、Claude とチャットして、プロジェクトにどのような変更を加えたいかを伝えましょう。codemcp がコードに変更を加えるたびに、コミットが生成されます。

このツールを使用したサンプルのトランスクリプトを見るには、以下をご覧ください。

• 新しい機能を実装する
• 失敗したテストを修正する
• リファクタリングを行う

codemcp はチャットごとにコミットを生成し、機能の作業に合わせてそれを修正します。

哲学

• レート制限を受けたら、他のことに時間を割いてください（Claude のコードのレビュー、他の人のコードのレビュー、計画を立てる、会議を行うなど）。
• これは自律的なエージェントではありません。少なくとも、チャットのたびに介入して変更内容を確認し、次の変更を依頼する必要があります。1回のチャットで多くの作業を依頼することはできますが、Claude Desktopの出力制限に達し、エージェントを手動で「続行」する必要がある可能性が高くなります。この状況を受け入れ、中断を利用してClaudeが適切な対応をしているか確認しましょう。
• クロードが軌道から外れると、金銭的な損失ではなく時間的な損失になります。状況に応じて行動しましょう。時間がボトルネックになっている場合は、クロードの増分出力を注意深く監視してください。

構成

codemcp.tomlでサポートされているすべての設定オプションは次のとおりです。

チャットでプロジェクトを初期化すると、 project_promptが読み込まれます。

commandsセクションでは、特定のツールのコマンドを設定できます。コマンド名はLLMに伝えられ、LLMはコマンドをいつ実行するかを決定します。project_prompt project_promptはツールの使用方法の説明を追加できます。また、ツールごとに具体的な指示を指定できる、より詳細な構文もサポートしています。

トラブルシューティング

インスペクタを使用してサーバーを実行するには、次を使用します。

ログは~/.codemcp/codemcp.logに書き込まれます。ログレベルは~/.codemcprcにあるグローバル設定ファイルで設定できます。

ログ記録はプロジェクトごとに構成できませんが、Claude Desktop を複数のプロジェクトで並行して使用することは難しいため、これはあまり問題にはなりません。

貢献

CONTRIBUTING.mdを参照してください。