🚀 MCP BatchIt 工具指南

MCP BatchIt 是一款強大的工具，它能通過單個請求執行多個操作。藉助並行處理功能，可同時運行多個子操作，還能根據需求在子操作失敗時停止後續操作。此外，它通過連接緩存機制，有效提高了與目標服務器交互的效率。

🚀 快速開始

1. 指定目標服務器

{
  "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. 定義操作

{
  "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. 配置選項

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

✨ 主要特性

並行處理：允許同時運行多個子操作，提升處理效率。
錯誤停止：若某個子操作失敗，可選擇停止後續的操作，便於控制流程。
連接緩存：為提高效率，BatchIt 會緩存目標服務器的連接，直至出現空閒超時。

📚 詳細文檔

常見問題解答

Q1: 如果子操作 #2 依賴於子操作 #1 的結果，是否需要多次調用 BatchIt？ 是的。BatchIt 不會在同一個請求中傳遞數據。建議採用多階段調用（如上文示例所示）。

Q2: 為什麼有時會看到“Tool create_directory not found”錯誤？ 這是因為你的 transport 可能指向了聚合器腳本本身，而不是真正的 MCP 服務器。請確保引用類似 @modelcontextprotocol/server-filesystem 的真實 MCP 服務器。

Q3: 是否可以同時實現並行處理和錯誤停止？ 當然可以。如果某個子操作失敗，已啟動的其他子操作會繼續運行，但尚未啟動的操作將被跳過。

Q4: BatchIt 是否會重新啟動目標服務器每次調用？ 不一定。默認情況下，BatchIt 會緩存連接，直到出現空閒超時。你也可以通過設置 keepAlive 配置選項來控制此行為。

Q5: 如果在中間發生錯誤，是否可以返回部分結果？ 是的。最終響應將包含所有在錯誤發生前完成的子操作狀態，以及失敗的子操作。如果啟用了 stopOnError，後續操作將被跳過。