Codemode MCP

🚀 Code Mode MCP Server

このプロジェクトは、MCPサーバーの「Code Mode」ワークフローをローカルで実装したものです。複数のツール呼び出しに苦労する代わりに、LLMはシンプルなHTTPプロキシを呼び出すTypeScript/JavaScriptコードを書いて、MCPサーバーにアクセスします。

🚀 クイックスタート

このリポジトリでの作業は停止し、以下のリポジトリに移行しました。 https://github.com/jx-codes/lootbox

こちらは、コードモードに対するより洗練されたアプローチです。

✨ 主な機能

• LLMに最適なワークフロー：LLMはコードを書くことに長けています。このサーバーは、LLMにexecute_codeという1つのツールを提供し、コードを書いてHTTPリクエストを行うことでMCPサーバーにアクセスできます。
• HTTPプロキシによる透過的な転送：HTTPプロキシがリクエストを実際のMCPサーバーに透過的に転送し、結果をLLMに返します。

📦 インストール

前提条件

• Bun (最新バージョン)
• Deno (コード実行サンドボックス用)
• MCP互換クライアント (Claude Desktop、Cursor、Copilot付きのVS Codeなど)

セットアップ

1. リポジトリをクローンする

git clone https://github.com/jx-codes/codemode-mcp.git
cd codemode-mcp

2. 依存関係をインストールする

bun install

3. サーバーを設定する (オプション)

codemode-config.jsonファイルを作成して設定をカスタマイズします。

{
   "proxyPort": 3001,
   "configDirectories": [
      "~/.config/mcp/servers",
      "./mcp-servers",
      "./"
   ]
}

4. MCPサーバーを設定する

上記で指定したディレクトリのいずれかに、.mcp.jsonファイルを作成してMCPサーバーの設定を行います。

{
   "mcpServers": {
      "fs": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
         "env": {}
      }
   }
}

💻 使用例

基本的な使用法

単一のMCPサーバー呼び出し

直接ツールを呼び出す代わりに、LLMは以下のようなコードを書きます。

// 利用可能なサーバーをリストする
const servers = await fetch("http://localhost:3001/mcp/servers").then((r) =>
  r.json()
);
console.log("利用可能なサーバー:", servers);

// ファイルシステムサーバー上のツールを呼び出す
const result = await fetch("http://localhost:3001/mcp/call", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    server: "fs",
    tool: "read_file",
    args: { path: "/tmp/example.txt" },
  }),
}).then((r) => r.json());

console.log("ファイルの内容:", result);

高度な使用法

複数の操作をチェーンする

操作をチェーンするときに本当のパワーが発揮されます。

// ファイルのリストを取得する
const files = await fetch("http://localhost:3001/mcp/call", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    server: "fs",
    tool: "list_directory",
    args: { path: "/tmp" },
  }),
}).then((r) => r.json());

// 各ファイルを処理する
for (const file of files.content[0].text.split("\n")) {
  if (file.endsWith(".txt")) {
    const content = await fetch("http://localhost:3001/mcp/call", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        server: "fs",
        tool: "read_file",
        args: { path: `/tmp/${file}` },
      }),
    }).then((r) => r.json());

    console.log(`${file}: ${content.content[0].text.length} 文字`);
  }
}

📚 ドキュメント

ツール

execute_code

MCPプロキシへのネットワークアクセスを持つTypeScript/JavaScriptコードを実行します。

パラメータ:

• code (文字列): 実行するコード
• typescript (ブール値): TypeScriptモード (デフォルト: true)

プロキシエンドポイント:

• GET /mcp/servers - 利用可能なMCPサーバーをリストする
• GET /mcp/{server}/tools - サーバーのツールをリストする
• POST /mcp/call - ツールを呼び出す (ボディ: {server, tool, args})

check_deno_version

Denoのインストール状態を確認します。

list_servers_with_tools

すべての利用可能なMCPサーバーとそのツールの包括的な概要を取得します。LLMが消費するために最適化された構造化JSONデータを返し、完全なツールスキーマとサーバーのステータス情報を含みます。

JSON出力構造:

{
  "summary": {
    "totalServers": 2,
    "successfulServers": 2,
    "totalTools": 4
  },
  "servers": [
    {
      "server": "filesystem",
      "status": "success",
      "toolCount": 3,
      "tools": [
        {
          "name": "read_file",
          "description": "ファイルの内容を読み取る",
          "inputSchema": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string",
                "description": "読み取るファイルのパス"
              }
            },
            "required": ["path"]
          }
        }
      ]
    },
    {
      "server": "database",
      "status": "success",
      "toolCount": 1,
      "tools": [
        {
          "name": "query",
          "description": "SQLクエリを実行する",
          "inputSchema": {
            "type": "object",
            "properties": {
              "query": {
                "type": "string",
                "description": "実行するSQLクエリ"
              }
            },
            "required": ["query"]
          }
        }
      ]
    }
  ]
}

設定

codemode-config.jsonを作成します。

{
  "proxyPort": 3001,
  "configDirectories": ["~/.config/mcp/servers", "./mcp-servers", "./"]
}

上記のディレクトリの.mcp.jsonファイルにMCPサーバーを追加します。

{
  "mcpServers": {
    "fs": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
      "env": {}
    }
  }
}

なぜこの方式が良いか

従来のMCP: LLM → ツール呼び出し → MCPサーバー → 結果 → LLM → ツール呼び出し → ...

• LLMはツールの構文に苦労します。
• 各呼び出しはニューラルネットワークを介して行われます。
• 操作をチェーンするのが難しいです。
• 合成ツールの例でのトレーニングに制限されています。

Code Mode: LLM → コードを書く → コードがプロキシを呼び出す → プロキシがMCPに転送する → 結果

• LLMはコードを書くことに優れています (トレーニングに数百万の実際の例があります)。
• コードは自然に操作をチェーンできます。
• 結果はコードロジックを通じて流れ、ニューラルネットワークを介さないため、自然な構成とデータ処理が可能です。

セキュリティ

• コードはDenoサンドボックス内でネットワークアクセスのみで実行されます。
• ファイルシステム、環境、またはシステムへのアクセスはありません。
• 30秒の実行タイムアウトが設定されています。
• MCPサーバーは制御されたプロキシを介してアクセスされます。
• 一時ファイルは自動的にクリーンアップされます。

トラブルシューティング

• "Deno not installed": Denoをインストールして再起動してください。
• "Permission denied": コードが制限されたリソースにアクセスしようとしています。
• "Module not found": インポートにhttps://URLを使用してください。
• "Execution timeout": コードを最適化するか、小さな操作に分割してください。

今後の予定 (可能性あり)

• MCPプロキシに対して、mcp.tool('name', args);のようなよりシンプルなAPIレイヤーを提供する。
  • ユーザーコードを実行する前に、独自のTypeScriptファイルをDenoスコープに注入することで簡単に実現できます。
• より多くの設定オプションを追加する。
• ツールを何らかの方法でフィルタリングする。
• 自分のワークフローでもっとテストして結果を確認する。

Denoコードの参考元: https://github.com/Timtech4u/deno-mcp-server