AI智能体 MCP通讯协议调式工具cli

跨平台AI智能体 MCP通讯协议调式工具cli

mcpclient 工具使用指南

mcpclient 是一个命令行工具，用于与 MCP（AI智能体通讯协议）服务器进行交互。它支持两种主要功能：调用远程工具和列出服务器上所有可用的工具。

1. 前置条件

   MCP 服务器：一个正在运行的 MCP 服务器，mcpclient 可以连接到该服务器。

2. mcpclient 用法概述

mcpclient 的通用语法如下：

mcpclient <服务器URL> <命令或JSON数据>

    <服务器URL>：您的 MCP 服务器的 URL（例如，http://127.0.0.1:8000/mcp）。

    <命令或JSON数据>：这可以是特定的命令 (list)，也可以是用于工具调用的 JSON 字符串或 JSON 文件路径。

3. 调用 MCP 工具

要调用 MCP 服务器上的特定工具，您可以将 JSON-RPC 2.0 请求作为字符串或文件路径提供。

3.1. 使用 JSON 字符串

直接将 JSON-RPC 请求作为字符串参数提供。请务必为您的命令行环境正确转义 JSON 字符串中的双引号。

hello 函数的 JSON 请求示例：
JSON

{
  "jsonrpc": "2.0",
  "method": "hello",
  "params": {
    "name": "World"
  },
  "id": "1"
}

在命令行中运行：

mcpclient http://127.0.0.1:8000/mcp "{\"jsonrpc\": \"2.0\", \"method\": \"hello\", \"params\": {\"name\": \"18k.icu\"}, \"id\": \"1\"}"

3.2. 使用 JSON 文件

您也可以将 JSON-RPC 请求写入一个文件（例如，request.json），然后提供该文件的路径。

test.json 文件内容示例：
JSON

{
  "jsonrpc": "2.0",
  "method": "my_custom_tool",
  "params": {
    "arg1": "value1",
    "arg2": 123
  },
  "id": "abc-456"
}

在命令行中运行：

mcpclient http://127.0.0.1:8000/mcp test.json

4. 列出所有可用工具

要获取 MCP 服务器上所有注册工具的列表，请使用 list 命令。

在命令行中运行：

mcpclient http://127.0.0.1:8000/mcp list

该命令将输出服务器上每个可用工具的名称、描述以及输入参数（包括它们的类型和描述）。

https://github.com/0x7556/PentestMCP/releases/tag/mcpclient