初学者的模型上下文协议(MCP)课程

发表于 2025-08-12 12:52:05 | 已阅读: 6512  次

运行此示例

建议安装 uv,但这不是必须的,详见说明

-0- 创建一个虚拟环境

python -m venv venv

-1- 激活虚拟环境

venv\Scripts\activate

-2- 安装依赖项

pip install "mcp[cli]"

-3- 运行示例

mcp run server.py

-4- 测试示例

在一个终端中运行服务器的同时,打开另一个终端并运行以下命令:

mcp dev server.py

这将启动一个带有可视化界面的网络服务器,允许你测试该示例。

服务器连接后:

  • 尝试列出工具并运行 add,参数为 2 和 4,你应该会在结果中看到 6。
  • 进入资源和资源模板,调用 get_greeting,输入一个名字,你应该会看到包含你提供的名字的问候语。

在 CLI 模式下测试

你运行的 inspector 实际上是一个 Node.js 应用,而 mcp dev 是它的一个封装。

你可以通过运行以下命令直接以 CLI 模式启动它:

npx @modelcontextprotocol/inspector --cli mcp run server.py --method tools/list

这将列出服务器中可用的所有工具。你应该会看到以下输出:

{
  "tools": [
    {
      "name": "add",
      "description": "Add two numbers",
      "inputSchema": {
        "type": "object",
        "properties": {
          "a": {
            "title": "A",
            "type": "integer"
          },
          "b": {
            "title": "B",
            "type": "integer"
          }
        },
        "required": [
          "a",
          "b"
        ],
        "title": "addArguments"
      }
    }
  ]
}

要调用一个工具,请输入:

npx @modelcontextprotocol/inspector --cli mcp run server.py --method tools/call --tool-name add --tool-arg a=1 --tool-arg b=2

你应该会看到以下输出:

{
  "content": [
    {
      "type": "text",
      "text": "3"
    }
  ],
  "isError": false
}

![!TIP] 通常在 CLI 模式下运行 inspector 比在浏览器中快得多。 在这里了解更多关于 inspector 的信息。

免责声明
本文档使用AI翻译服务Co-op Translator进行翻译。尽管我们努力确保准确性,但请注意,自动翻译可能包含错误或不准确之处。应以原始语言的文档作为权威来源。对于关键信息,建议使用专业人工翻译。因使用本翻译而导致的任何误解或误读,我们概不负责。