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：如果有无效的命令行参数。
• 其他在工具执行过程中出现的异常。