Batchit

🚀 MCP BatchIt ツールガイド

MCP BatchItは、単一のリクエストで複数の操作を実行する強力なツールです。このツールは、並列処理やエラー時の操作停止、接続キャッシュなどの機能を提供し、効率的な操作を可能にします。

🚀 クイックスタート

MCP BatchItを使用するには、以下の手順に従ってください。

1. ターゲットサーバーの指定

以下のJSONを使用してターゲットサーバーを指定します。

{
  "targetServer": {
    "name": "filesystem",
    "serverType": {
      "type": "filesystem",
      "config": {
        "rootDirectory": "C:/Users/Chewy/Documents/GitHub/ryanjoachim/mcp-batchit"
      }
    },
    "transport": {
      "type": "stdio",
      "command": "cmd.exe",
      "args": [
        "/c",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:/Users/Chewy/Documents/GitHub/ryanjoachim/mcp-batchit"
      ]
    }
  }
}

2. 操作の定義

操作をJSON形式で定義します。以下は例です。

{
  "operations": [
    {
      "tool": "create_directory",
      "arguments": {
        "path": "C:/Users/Chewy/Documents/GitHub/ryanjoachim/mcp-batchit/memory-bank"
      }
    },
    {
      "tool": "write_file",
      "arguments": {
        "path": "C:/Users/Chewy/Documents/GitHub/ryanjoachim/mcp-batchit/memory-bank/productContext.md",
        "content": "# MCP BatchIt Product Context\\n\\n## Purpose\\n..."
      }
    }
    // 他の操作も同様に追加
  ]
}

3. 設定オプションの構成

以下のJSONを使用して設定オプションを構成します。

{
  "options": {
    "maxConcurrent": 1,
    "stopOnError": true,
    "timeoutMs": 30000
  }
}

✨ 主な機能

• 並列処理：複数のサブ操作を同時に実行できます。
• エラー停止：サブ操作が失敗した場合、後続の操作を停止することができます。
• 接続キャッシュ：効率を向上させるため、BatchItはターゲットサーバーの接続をキャッシュし、アイドルタイムアウトまで保持します。

📚 ドキュメント

よくある質問

Q1: サブ操作 #2 がサブ操作 #1 の結果に依存する場合、BatchItを複数回呼び出す必要がありますか？ はい。BatchItは同じリクエスト内でデータを渡さないため、多段階の呼び出しを行うことをおすすめします（上記の例のように）。

Q2: なぜ「Tool create_directory not found」エラーが表示されることがありますか？ これは、transport が集約スクリプト自体を指している場合があります。本物のMCPサーバー（例：@modelcontextprotocol/server-filesystem）を参照するようにしてください。

Q3: 並列処理とエラー停止を同時に実現できますか？ もちろんです。サブ操作が失敗した場合、既に開始された他のサブ操作は続行されますが、まだ開始されていない操作はスキップされます。

Q4: BatchItは毎回呼び出すたびにターゲットサーバーを再起動しますか？ 必ずしもそうではありません。デフォルトでは、BatchItは接続をキャッシュし、アイドルタイムアウトまで保持します。keepAlive 設定オプションを使用してこの動作を制御することもできます。

Q5: 途中でエラーが発生した場合、部分的な結果を返すことはできますか？ はい。最終的なレスポンスには、エラーが発生する前に完了したすべてのサブ操作の状態と、失敗したサブ操作が含まれます。stopOnError を有効にすると、後続の操作はスキップされます。

📄 ライセンス

MIT