はじめに
codemcpは、以下のために設計されたオープンソースツールです。 クロード Edward Z. YangがGitHubで開発したデスクトップ・ユーザー・デザイン。これにより、Claude Desktopは便利なペアプログラミング・アシスタントとなる。ユーザーは、手作業でコードをコピー&ペーストすることなく、ダイアログを通じて直接、ローカルのコードベースの機能実装、バグ修正、リファクタリングをClaudeに依頼することができます。 codemcpサポート アンソロピック クロード・プロのサブスクリプション・サービス(月額20ドル)は、高額なAPI使用料を回避できる。ツールセットを制限し、Gitバージョン管理の使用を強制することで、安全かつ制御されたAI操作を保証します。開発者は、様々なプログラミングシナリオのために、お気に入りのIDEでコードをチェックし、微調整することができます。
機能一覧
- ローカルコードの直接編集クロードでプロジェクトファイルを変更し、変更を自動的に保存します。
- テストの実行とフォーマットテストスクリプトとフォーマットコマンドを実行し、コードの品質を維持する。
- Gitコミット管理各変更に対してGitコミットを生成し、表示とロールバックをサポートします。
- プロジェクト構成サポートカスタム・コマンドを読み込むために、設定ファイルを使ってプロジェクトを初期化する。
- ログ追跡トラブルシューティングを容易にするために、操作の詳細を記録します。
ヘルプの使用
設置プロセス
codemcpを使用するには、まず依存関係をインストールし、環境を設定する必要があります。以下はその詳細な手順である:
- uvツールのインストール
codemcpの実行にはuvが必要です。まずuvをインストールしてください。公式のインストールスクリプトを使うことをお勧めします:- Linux/MacOS:
curl -LsSf https://astral.sh/uv/install.sh | sh
- Windows(PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
インストール後
uv --バージョン
バージョンを確認し、インストールが成功したことを確認する。 - Linux/MacOS:
- クロードデスクトップの設定
オープンまたは作成claude_desktop_config.json
ファイルに以下を追加する:
{
"mcpServers":{。
"codemcp": {
"命令": "uvx"、
"args": [
"--from".
"git+https://github.com/ezyang/codemcp@prod"、
"codemcp"
]
}
}
}
保存後、Claude Desktopはuvx経由でGitHubからcodemcpを読み込みます。
- プロジェクト・プロファイルの設定
Gitリポジトリのルートにcodemcp.toml
ドキュメント例
format = ["./run_format.sh"]。
test = ["./run_test.sh"]。
フォーマット
コード正規化のためのフォーマットスクリプトのパスを指定します。テスト
テストを実行するためのテストスクリプトのパスを指定します。
これらのスクリプトは、仮想環境を有効にし、正しく実行できるようにするために、自分で書く必要があります。
使用方法
インストールが完了したら、クロードデスクトップでcodemcpを操作することができます:
1.初期化プロジェクト
クロードデスクトップで新規プロジェクトを作成し、プロジェクト指示に入力します:
何かをする前に、まずプロジェクト$PROJECT_DIRを起動してください。
そうしれいかん $project_dir
プロジェクトのパスに置き換えてください。 /ユーザー/ユーザー名/マイプロジェクト
.初期化後、codemcp は codemcp.toml
コンフィギュレーション。
2.対話を通じてコードを変える
Claude Desktop のチャットウィンドウで、変更したい内容を直接 Claude に伝えてください。例
- "フィボナッチ級数を計算する関数をmain.pyに追加する"
- "utils.pyのロジックエラーを修正"
Claudeはcodemcpを使ってファイルを編集し、変更のたびに自動的にGitコミットを生成します。これはギットログ
投稿履歴を見る
3.コード変更のチェックと管理
別のブランチ(たとえば 開発する
)に設定されたデフォルト・ブランチでcodemcpを実行する。 メイン
以下は一般的なGitコマンドです。以下は一般的なGitコマンドです:
- 変更を見る::
git diff main
マスターブランチとの差分を表示します。 - 変更の受け入れ::
git fetch . 開発:メイン
変更をmasterブランチにマージする。- 提出履歴の保持:最初
git checkout main
もう一度git merge develop --no-ff
. - 圧縮の提出:実行
git rebase -i
何をしたいのかわからない場合は、squashを選択してからfetchを実行する。
- 提出履歴の保持:最初
- 変更の撤回::
git reset --keep main
マスターブランチの状態に戻す。
4.実装テストとフォーマット
もし テスト
歌で応える フォーマット
クロードにこれらのコマンドを実行するように頼むことができる。例えば
- "すべてのテストを実行し、コードが機能するかチェックする"
- "ミッション完了後のコードのフォーマット"
テストはタスクの途中で実行され、フォーマットはタスクの最後に実行される。
5.流量制限への対応
Claude Pro には時間制限があり、Claude はストリーム制限に遭遇すると一時停止します。この時間を利用することができます:
- 生成されたコードをチェックする。
- 次の仕事を計画する。
制限が解除されたら、対話を続ければいい。
6.日誌の閲覧
問題がある場合は ~/.codemcp/codemcp.log
ログファイル。より詳細なログを記録するには ~/.codemcprc
::
[ロガー]
冗長度 = "DEBUG"
サポートされているレベルは、DEBUG、INFO、WARNING、ERROR、CRITICALである。
注目の機能操作
- 安全設計: codemcpは、悪用を避けるためにクロードのツールの範囲を制限しています。すべての変更はGit経由でロールバックされる。
- IDE互換コードの変更は、どのIDE(VS Codeなど)でもレビューや調整が可能です。
- 手動制御非自動化エージェントでは、コードが正しい方向に進んでいるかどうかを確認するために、各タスクをユーザーがチェックし、継続する必要がある。
これらのステップを踏めば、codemcpをすぐに使い始めることができ、プログラミングの効率を向上させることができます。