MCP Tools Cli

🚀 mcp-tools-cli 工具

mcp-tools-cli 是一個強大的命令行客戶端，專為與模型上下文協議（MCP）服務器進行交互而設計。藉助它，你可以輕鬆地列出服務器上的可用工具，或者調用特定工具，極大地提升了與 MCP 服務器交互的效率。

🚀 快速開始

安裝

你可以使用 pip 來安裝 mcp-tools-cli：

pip install mcp-tools-cli

配置

該客戶端使用名為 mcp_config.json 的配置文件來存儲與 MCP 服務器的連接信息。創建一個包含以下內容的文件 mcp_config.json：

{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
    }
  }
}

請將值替換為你自己的 MCP 服務器配置。

使用方法

mcp-tools-cli <action> --mcp-name <mcp_name> [options]

參數

• action（必需）：要執行的操作。必須是以下之一：
  • list-tools：列出 MCP 服務器上的可用工具。
  • call-tool：調用 MCP 服務器上的特定工具。
• --mcp-name（必需）：要在其上連接的 MCP 服務器名稱，如 mcp_config.json 中定義的。
• --tool-name（必需，當操作為 call-tool 時）：要調用的工具名稱。
• --tool-args（可選）：工具的參數。可以是 JSON 字符串或單個字符串值。如果單個字符串值不是有效的 JSON，則將其作為工具的 query 參數傳遞。
• --config-path（可選）：配置文件 mcp_config.json 的路徑。默認為當前目錄中的 mcp_config.json。

配置文件格式

該客戶端使用名為 mcp_config.json 的配置文件來存儲與 MCP 服務器的連接信息。文件應採用以下格式：

{
  "mcpServers": {
    "<mcp_name>": {
      "command": "<運行服務器的命令>",
      "args": ["<參數1>", "<參數2>", ...],
      "env": {
        "<環境變量名稱>": "<環境變量值>",
        ...
      }
    },
    ...
  }
}

請將 <mcp_name> 替換為你的 MCP 服務器名稱（例如 time）。command、args 和 env 字段指定如何運行服務器。

示例

提供了一個使用 時間 MCP 服務器 的示例在 mcp_config.sample.json 中。如果你希望使用它，請預先執行 pip install mcp-server-time。

• 列出可用工具：

mcp-tools-cli list-tools --mcp-name time --config-path mcp_config.sample.json

• 調用 get_current_time 工具並傳遞查詢：

mcp-tools-cli call-tool --mcp-name time --tool-name get_current_time --config-path mcp_config.sample.json

錯誤處理

如果出現任何錯誤，客戶端會在控制檯打印錯誤消息，例如：

• FileNotFoundError：如果配置文件未找到。
• json.JSONDecodeError：如果配置文件不是有效的 JSON 文件。
• ValueError：如果配置文件中未找到 MCP 服務器，或命令缺失。
• argparse.ArgumentError：如果有無效的命令行參數。
• 其他在工具執行過程中出現的異常。