Claude Code MCP Server

クロード・コード MCP サーバー

権限を自動的にバイパスして、ワンショット モードで Claude Code を実行できるようにする MCP (Model Context Protocol) サーバー。

Cursor が複雑で複数ステップの編集や操作に苦労することがあることに気づきましたか？このサーバーは、強力な統合ツールclaude_codeを搭載しており、Claude をより直接的かつ有能なコーディングタスクのエージェントとして活用することを目指しています。

概要

このMCPサーバーは、LLMがClaude Codeと連携するために使用できるツールを1つ提供します。Claude Desktopや他のMCPクライアントと統合することで、LLMは以下のことが可能になります。

• すべての権限をバイパスして Claude Code を実行します ( --dangerously-skip-permissionsを使用)
• 許可の中断なしに、任意のプロンプトで Claude コードを実行します。
• ファイル編集機能に直接アクセス
• 特定のツールをデフォルトで有効にする

利点

• Claude/Windsurf はファイルの編集に苦労することがよくあります。Claude Code の方が優れていて、編集速度も速いです。
• 複数のコマンドを直接実行するのではなく、キューに入れることができます。これによりコンテキスト空間が節約され、より重要な情報がより長く保持され、圧縮処理の回数が少なくなります。
• ファイル操作、Git、その他の操作には、高コストなモデルは必要ありません。Claude Codeは、Antropic Maxにサインアップすれば、非常に費用対効果の高いものになります。Geminiまたはo3をMaxモードで使用し、タスクを安価なモデルにオフロードすることでコストを削減できます。
• Claude はより広範囲のシステム アクセスを持ち、Cursor/Windsurf ではできない (またはできないと思われている) 操作を実行できます。そのため、行き詰まったときはいつでも、「Claude コードを使用する」と尋ねるだけで、通常は行き詰まりが解消されます。
• エージェントのルール内のエージェント。

前提条件

• Node.js v20以降（fnmまたはnvmを使用してインストールしてください）
• Claude CLI がローカルにインストールされ (実行して /doctor を呼び出す)、 -dangerously-skip-permissionsが受け入れられました。

構成

環境変数

• CLAUDE_CLI_NAME : Claude CLIバイナリ名を上書きするか、絶対パスを指定します（デフォルト： claude ）。これにより、カスタムClaude CLIバイナリを使用できます。これは以下の場合に便利です。
  • カスタムClaude CLIラッパーの使用
  • モックバイナリを使ったテスト
  • 複数の Claude CLI バージョンを並行して実行する

  サポートされている形式:

  • 単純な名前: CLAUDE_CLI_NAME=claude-customまたはCLAUDE_CLI_NAME=claude-v2
  • 絶対パス: CLAUDE_CLI_NAME=/path/to/custom/claude

  相対パス (例: ./claudeまたは../claude ) は許可されておらず、エラーが発生します。

  単純な名前に設定すると、サーバーは指定されたバイナリを次の場所で検索します。

  1. システムPATH（デフォルトのclaudeコマンドの代わりに）

  注意: ローカル ユーザーのインストール パス ( ~/.claude/local/claude ) は引き続きチェックされますが、デフォルトのclaudeバイナリに対してのみチェックされます。

• MCP_CLAUDE_DEBUG : デバッグログを有効にする（詳細出力の場合はtrueに設定）

インストールと使用方法

このサーバーを使用するには、 npxを使用してインストールすることをお勧めします。

カスタムの Claude CLI バイナリ名を使用するには、環境変数を指定します。

重要な初回セットアップ：権限の承認

MCP サーバーがclaude_codeツールを正常に使用できるようにするには、まず--dangerously-skip-permissionsフラグを使用して Claude CLI を手動で 1 回実行し、ログインして利用規約に同意する必要があります。

これは、Claude CLI による 1 回限りの要件です。

プロンプトに従って承認してください。承認が完了すると、MCPサーバーは非対話型でフラグを使用できるようになります。

macOSはツールの初回実行時にあらゆる種類のフォルダ権限を要求し、最初の実行は失敗する場合があります。その後の実行は正常に動作します。

MCPクライアントへの接続

サーバーをセットアップした後、MCP クライアント (Cursor やmcp.jsonまたはmcp_config.jsonを使用するその他のクライアントなど) を構成する必要があります。

MCP 構成ファイル

設定は通常JSONファイルで行います。名前と場所はクライアントによって異なります。

カーソル

カーソルはmcp.jsonを使用します。

• macOS: ~/.cursor/mcp.json
• Windows: %APPDATA%\\Cursor\\mcp.json
• Linux: ~/.config/cursor/mcp.json

ウィンドサーフィン

Windsurfユーザーはmcp_config.jsonを使用します

• macOS: ~/.codeium/windsurf/mcp_config.json
• Windows: %APPDATA%\\Codeium\\windsurf\\mcp_config.json
• Linux: ~/.config/.codeium/windsurf/mcp_config.json

(注: 一部の混合セットアップでは、Cursor もインストールされている場合、これらのクライアントは Cursor の~/.cursor/mcp.jsonパスを使用するようにフォールバックする可能性があります。Codeium 拡張機能を使用する場合は、Codeium 固有のパスを優先してください。)

このファイルが存在しない場合は作成してください。claude_code claude_code設定を追加または更新します。

提供されるツール

このサーバーは、1 つの主要なツールを公開します。

claude_code

--dangerously-skip-permissionsを指定して Claude Code CLI を直接実行します。

引数:

• prompt (文字列、必須): Claude Code に送信するプロンプト。
• options （オブジェクト、オプション）:
  • tools （文字列の配列、オプション）: 有効にする特定のClaudeツール（例： Bash 、 Read 、 Write ）。一般的なツールはデフォルトで有効になっています。

MCP リクエストの例:

例

以下に、サーバーが動作している様子を示す視覚的な例をいくつか示します。

ESLint設定の修正

Claude Code MCP ツールを使用して、古い構成ファイルを削除し、新しい構成ファイルを作成することで、ESLint セットアップを対話的に修正する例を次に示します。

ファイルの一覧表示の例

以下は、ディレクトリ内のファイルを一覧表示する Claude Code ツールの例です。

主なユースケース

このサーバーは、統合されたclaude_codeツールを通じて、AIがClaude Code CLIに直接アクセスできるようにすることで、幅広い強力な機能を実現します。以下は、実現可能な例です。

1. コード生成、分析、リファクタリング:
   • "Generate a Python script to parse CSV data and output JSON."
   • "Analyze my_script.py for potential bugs and suggest improvements."
2. ファイル システム操作 (作成、読み取り、編集、管理):
   • ファイルの作成: "Your work folder is /Users/steipete/my_project\n\nCreate a new file named 'config.yml' in the 'app/settings' directory with the following content:\nport: 8080\ndatabase: main_db"
   • ファイルの編集: "Your work folder is /Users/steipete/my_project\n\nEdit file 'public/css/style.css': Add a new CSS rule at the end to make all 'h2' elements have a 'color: navy'."
   • 移動/コピー/削除: "Your work folder is /Users/steipete/my_project\n\nMove the file 'report.docx' from the 'drafts' folder to the 'final_reports' folder and rename it to 'Q1_Report_Final.docx'."
3. バージョン管理（Git）：
   • "Your work folder is /Users/steipete/my_project\n\n1. Stage the file 'src/main.java'.\n2. Commit the changes with the message 'feat: Implement user authentication'.\n3. Push the commit to the 'develop' branch on origin."
4. ターミナルコマンドの実行:
   • "Your work folder is /Users/steipete/my_project/frontend\n\nRun the command 'npm run build'."
   • "Open the URL https://developer.mozilla.org in my default web browser."
5. ウェブ検索と要約:
   • "Search the web for 'benefits of server-side rendering' and provide a concise summary."
6. 複雑な複数ステップのワークフロー:
   • バージョン バンプ、変更ログの更新、リリースのタグ付けを自動化します。 "Your work folder is /Users/steipete/my_project\n\nFollow these steps: 1. Update the version in package.json to 2.5.0. 2. Add a new section to CHANGELOG.md for version 2.5.0 with the heading '### Added' and list 'New feature X'. 3. Stage package.json and CHANGELOG.md. 4. Commit with message 'release: version 2.5.0'. 5. Push the commit. 6. Create and push a git tag v2.5.0."
7. 構文エラーのあるファイルの修復:
   • "Your work folder is /path/to/project\n\nThe file 'src/utils/parser.js' has syntax errors after a recent complex edit that broke its structure. Please analyze it, identify the syntax errors, and correct the file to make it valid JavaScript again, ensuring the original logic is preserved as much as possible."
8. GitHub とのやり取り (例: プル リクエストの作成):
   • "Your work folder is /Users/steipete/my_project\n\nCreate a GitHub Pull Request in the repository 'owner/repo' from the 'feature-branch' to the 'main' branch. Title: 'feat: Implement new login flow'. Body: 'This PR adds a new and improved login experience for users.'"
9. GitHub とのやり取り (例: PR CI ステータスの確認):
   • "Your work folder is /Users/steipete/my_project\n\nCheck the status of CI checks for Pull Request #42 in the GitHub repository 'owner/repo'. Report if they have passed, failed, or are still running."

GitHub Actionsワークフローの修正

複雑な複数ステップの操作

この例では、ブランチの作成によるリリースの準備、複数のファイル ( package.json 、 CHANGELOG.md ) の更新、変更のコミット、プル リクエストの開始など、より複雑な複数ステップのタスクをすべて 1 つの一貫した操作でclaude_codeが処理する様子を示しています。

重要: ファイル システムまたは git 操作のプロンプトで、現在の作業ディレクトリ (CWD) コンテキストを必ず提供してください (例: "Your work folder is /path/to/project\n\n...your command..." )。

トラブルシューティング

• **「コマンドが見つかりません」(claude-code-mcp):**グローバルにインストールされている場合は、npm のグローバル bin ディレクトリがシステムの PATH に含まれていることを確認してください。npx npx使用している場合は、 npx自体が動作していることを確認してください。
• 「コマンドが見つかりません」（claude または ~/.claude/local/claude）： Claude CLI が正しくインストールされていることを確認してください。claude claude/doctorを実行するか、ドキュメントを確認してください。
• 権限の問題: 「重要な初回セットアップ」手順を実行したことを確認してください。
• サーバーからのJSONエラー: MCP_CLAUDE_DEBUGがtrueの場合、エラーメッセージまたはログがMCPのJSON解析に干渉する可能性があります。通常の動作にはfalseに設定してください。
• ESM/インポート エラー: Node.js v20 以降を使用していることを確認してください。

開発者向け: ローカルセットアップと貢献

このサーバーを開発または貢献する場合、あるいはテストのためにクローン リポジトリから実行する場合は、 「ローカル インストールおよび開発セットアップ ガイド」を参照してください。

テスト

このプロジェクトには包括的なテスト スイートが含まれています。

詳細なテストドキュメントについては、 E2E テスト ガイドを参照してください。

環境変数による設定

サーバーの動作は、次の環境変数を使用してカスタマイズできます。

• CLAUDE_CLI_PATH : Claude CLI 実行可能ファイルへの絶対パス。
  • デフォルト: ~/.claude/local/claudeをチェックし、 claudeにフォールバックします (PATH にあると想定)。
• MCP_CLAUDE_DEBUG : この MCP サーバーからの詳細なデバッグ ログを記録するにはtrueに設定します。デフォルト: false 。

これらは、シェル環境またはmcp.jsonサーバー構成のenvブロック内で設定できます ( mcp.jsonの例では、簡潔にするためにenvブロックは削除されていますが、必要に応じてサーバー プロセス用に設定する有効な方法です)。

貢献

貢献を歓迎します！環境設定の詳細については、ローカルインストールと開発セットアップガイドを参照してください。

問題とプル リクエストをGitHub リポジトリに送信します。

ライセンス

マサチューセッツ工科大学