MCP Server Playground 使用说明

项目简介

这是一个基于 TypeScript 构建的 MCP (Model Context Protocol) 服务器，旨在为开发者提供一个实验和学习 MCP 服务器开发的平台。它基于官方教程构建，并扩展了一些工具功能，可以与 Claude Desktop 和 Cursor IDE 等 LLM 客户端集成，用于测试和探索 MCP 协议的应用。

主要功能点

工具 (Tools) 注册与执行: 实现了 MCP 服务器的核心功能，可以注册和执行工具，目前预置了两个工具：
- 'calculate_sum': 接收两个数字作为输入，计算它们的和。（注意：代码实现有误，实际代码会加3个数，描述已按实际代码更正为加3个数，使用时请注意）
- 'httpbin_json': 调用 'httpbin.org/json' API，返回 JSON 数据。
基于 Stdio 的传输: 使用标准输入输出 (Stdio) 作为 MCP 服务器的传输协议，方便本地运行和集成。
能力声明: 声明服务器具备 'tools' 能力，允许客户端发现和调用工具。

安装步骤

克隆仓库:

git clone https://github.com/psaboia/mcp-server-playground
cd mcp-server-playground

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到此 MCP 服务器。请注意，此服务器通过标准输入输出 (stdio) 通信。

{
  "serverName": "mcp-server-playground",
  "command": "./build/index.js",
  "args": [],
  "transport": "stdio"
}

配置参数说明:

'serverName': MCP 服务器的名称，这里设置为 "mcp-server-playground"。
'command': 启动 MCP 服务器的可执行文件路径。在构建后，入口文件位于 'build/index.js'。由于是 Node.js 项目，需要确保 'node' 命令在您的环境变量 'PATH' 中。或者，您可以根据您的系统配置，使用绝对路径，例如 '/path/to/your/mcp-server-playground/build/index.js'。
'args': 启动服务器时传递的命令行参数。此示例服务器不需要任何参数，因此设置为空数组 '[]'。
'transport': 指定 MCP 服务器使用的传输协议。这里使用 'stdio'，表示标准输入输出。

请将以上 JSON 配置信息填入您的 MCP 客户端（例如 Claude Desktop 或 Cursor IDE）的 MCP 服务器配置中。

基本使用方法

启动 MCP 服务器: 无需手动启动，MCP 客户端会根据您提供的配置自动启动服务器。
在 MCP 客户端中使用工具: 连接成功后，在支持 MCP 协议的 LLM 客户端中，您可以：
- 列出工具: 客户端可以向服务器请求工具列表，并显示 'calculate_sum' 和 'httpbin_json' 这两个工具。
- 调用工具: 在与 LLM 对话时，当 LLM 需要使用工具时，它会根据工具的 'inputSchema' 构造请求，并发送给 MCP 服务器。
  - 例如，调用 'calculate_sum' 工具时，客户端需要提供 'a' 和 'b' 两个数字作为参数。服务器会返回计算结果。
  - 调用 'httpbin_json' 工具时，无需参数，服务器会返回从 'httpbin.org/json' 获取的 JSON 数据。

注意: 此项目主要用于学习和实验，工具功能较为简单。您可以根据需要扩展 'src/index.ts' 文件，添加更多工具和功能。

关键词