A Simple MCP Server and Client

一个简单的 MCP 服务和客户端

这是一个简单的模型上下文协议（MCP）服务和客户端实现，演示如何公开和访问天气信息。

服务

服务实现在 server.js 中，提供以下功能：

• 资源：

  • city://NewYork：纽约市的基本信息
  • city://London：伦敦的基本信息
  • city://Tokyo：东京的基本信息

• 工具：

  • get-weather：获取某个城市的天气预报，可设置城市名称和天数参数

• 提示词：

  • weather-advice：根据天气状况获取旅行建议

客户端

客户端实现在 client.js 中，演示如何：

• 连接到 MCP 服务
• 列出可用资源
• 读取指定的城市资源
• 调用天气预报工具
• 获取天气建议提示词

JSON-RPC 通信

此实现使用 JSON-RPC 2.0 作为客户端与服务之间的底层通信协议。使用的 JSON-RPC 核心概念包括：

• 方法：标准方法名称，例如 resources/list、resources/read、tools/call 和 prompts/get
• 参数：随方法调用发送的输入数据
• 请求 ID：用于将请求与响应对应起来的唯一标识符
• 结果/错误：结构化响应数据或错误信息

MCP SDK 抽象了其中大部分细节，但了解该协议有助于调试和自定义。查看控制台输出即可看到原始 JSON-RPC 消息。

运行服务和客户端

1. 启动客户端：

   node client.js
   

   启动客户端会自动将服务作为子进程启动。客户端将连接到服务并执行所有示例操作。

2. 单独启动服务：

   node server.js
   

传输机制

此示例使用 stdio（标准输入/输出）作为客户端与服务之间的传输机制。启动客户端时，它会将服务作为子进程启动，并通过 stdin/stdout 流与其通信。

此示例实现了自定义日志传输机制，用于展示客户端与服务之间交换的消息。这些消息会以便于阅读的格式记录到控制台，帮助理解该协议。

故障排查

如果资源请求或提示词请求超时，请检查服务实现。此示例针对特定请求类型加入了直接消息处理，以绕过当前 SDK 版本的限制。