MCP JSON-RPC 客户端和服务端示例

此仓库包含一个简单、对初学者友好的 MCP 风格的 JSON‑RPC 客户端和服务端示例，使用 JavaScript 实现。 该项目演示了使用 Node.js 的内置模块进行基本通信流程，没有任何外部依赖。

概述

• 服务端 (server.js):

  • 监听 TCP 端口 4000。
  • 实现两个 JSON‑RPC 方法：
    • initialize: 返回一个基本的功能对象（声明一个 "echo" 工具）。
    • echo: 将客户端提供的参数回显。

• 客户端 (client.js):

  • 连接到端口 4000 上的服务端。
  • 发送一个 initialize 请求，然后发送一个 echo 请求。
  • 记录从服务端收到的响应。

前提条件

• 您的系统上已安装 Node.js (建议 v10 或更高版本)。

快速开始

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 MCP JSON-RPC 客户端和服务端示例：

npx -y @smithery/cli install @melvincarvalho/mcpjs --client claude

手动安装

1. 克隆仓库:

   git clone https://github.com/sandy-mount/mcpjs.git
   cd mcp-jsonrpc-example
   

2. 运行服务端:

   打开一个终端窗口并运行：

   node server.js
   

   您应该看到类似以下的消息：

   Server listening on port 4000
   

3. 运行客户端:

   打开另一个终端窗口并运行：

   node client.js
   

   客户端将连接到服务端，发送 initialize 和 echo 请求，并显示响应。

工作原理

• 服务端 监听端口 4000 上的传入 TCP 连接。 当它收到一个 JSON‑RPC 消息（每个消息以换行符结尾）时，它会处理该请求：

  • 对于 initialize 方法，它返回一个包含基本功能和服务端信息的 JSON‑RPC 响应。
  • 对于 echo 方法，它返回请求中发送的参数。
  • 如果请求了未知方法，它会返回一个 JSON‑RPC 错误。

• 客户端 连接到服务端，发送一个 JSON‑RPC initialize 请求，等待一小段时间，然后发送一个 echo 请求。 来自服务端的响应将打印到控制台。

文件

• server.js — JSON‑RPC 服务端实现。
• client.js — JSON‑RPC 客户端实现。

自定义

您可以通过以下方式扩展此示例：

• 向服务端添加更多 JSON‑RPC 方法。
• 实现额外的错误处理和日志记录。
• 尝试不同的传输协议或添加 TLS 支持。

许可证

此项目根据 MIT 许可证获得许可。 有关详细信息，请参阅 LICENSE 文件。

贡献

欢迎提出问题或提交包含改进或建议的 pull request。

---

编码愉快！