MCP 简易服务器

一个实现了模型上下文协议 (MCP) 的简易服务器。

设置

1. 安装依赖:

npm install

2. 启动服务器:

npm start

服务器默认运行在 http://localhost:3001。

使用 Stdio 服务器

本项目包含一个基于 stdio 的 MCP 服务器实现，它通过标准输入/输出进行通信，而不是 HTTP/SSE。

运行 Stdio 服务器

npm run stdio

stdio 服务器通过 stdin 接收 JSON-RPC 消息，并通过 stdout 响应。所有日志都发送到 stderr，以避免干扰 JSON-RPC 消息。

使用 MCP Inspector

如果你想将 MCP Inspector 与 stdio 服务器一起使用，我们创建了一个桥接器，将基于 HTTP 的 inspector 连接到我们的 stdio 服务器：

npm run bridge

这将会：

1. 启动 stdio 服务器作为子进程
2. 在端口 3001 上创建一个 HTTP 服务器
3. 将来自 HTTP 的 JSON-RPC 请求转发到 stdio 服务器
4. 将响应返回给 HTTP 客户端

然后，你可以将 MCP Inspector 连接到 http://localhost:3001，它将与 stdio 服务器一起工作。

使用交互式 CLI

提供了一个交互式命令行界面，以便于与 stdio 服务器进行交互：

npm run cli

这将启动一个交互式 shell，你可以在其中输入搜索查询：

MCP CLI - MCP 服务器的交互式界面
输入 "exit" 或按 Ctrl+C 退出
示例:
  documents/javascript - 搜索包含关键字 "javascript" 的文档
  help - 显示此帮助消息
--------------------------------------------------
> 

你可以输入简单的关键字或完整的文档 URI 进行搜索。

使用示例客户端

包含一个示例客户端，用于演示如何以编程方式与 stdio 服务器通信：

npm run client <query>

例如：

npm run client javascript

这将会：

1. 启动 stdio 服务器作为子进程
2. 发送一个查询，查找匹配 "javascript" 的文档
3. 显示结果并退出

直接与 Stdio 服务器通信

你也可以通过管道传输 JSON-RPC 消息直接与 stdio 服务器通信：

echo '{"jsonrpc":"2.0","id":"1","method":"mcp.uri","params":{"uri":"documents/sample"}}' | node stdio-server.mjs

自定义域名设置

你可以通过在你的 hosts 文件中映射它来通过自定义域名访问服务器。

自动设置

使用 sudo 权限运行包含的设置脚本：

sudo ./hosts-setup.sh

这会将 mcp.local 添加到你的 hosts 文件，指向 127.0.0.1 并刷新你的 DNS 缓存。

手动设置

1. 编辑你的 hosts 文件：

   • 在 macOS/Linux 上：/etc/hosts
   • 在 Windows 上：C:\Windows\System32\drivers\etc\hosts

2. 添加以下行：

127.0.0.1 mcp.local

3. 刷新你的 DNS 缓存：

   • 在 macOS 上：sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
   • 在 Windows 上：ipconfig /flushdns
   • 在 Linux 上：取决于你的发行版

4. 在 http://mcp.local:3001 访问服务器

环境变量

你可以通过设置以下环境变量来自定义服务器：

• PORT: 服务器运行的端口 (默认: 3001)
• DOMAIN_NAME: 自定义域名 (默认: mcp.local)
• SERVER_IP: 绑定的 IP 地址 (默认: 127.0.0.1)

示例:

PORT=8080 DOMAIN_NAME=myapi.local npm start