无状态 Hono MCP 服务器

一个基于 Hono 的 MCP 服务器示例，使用 Streamable HTTP，基于官方的 Express 示例 simpleStatelessStreamableHttp.ts 进行开发，使用 fetch-to-node 进行转换，可部署到 Cloudflare Workers（以及其他支持 Hono 的环境）。

与 Express 示例的主要区别在于：

- import express, { Request, Response } from 'express';
+ import { Hono } from 'hono';
+ import { toFetchResponse, toReqRes } from 'fetch-to-node';

// ...

- const app = express();
- app.use(express.json());
+ const app = new Hono();

- app.post('/mcp', async (req: Request, res: Response) => {
+ app.post('/mcp', async (c) => {
+   const { req, res } = toReqRes(c.req.raw);

    const server = getServer();
    try {
      const transport: StreamableHTTPServerTransport = new StreamableHTTPServerTransport({
        sessionIdGenerator: undefined,
      });
      await server.connect(transport);
-     await transport.handleRequest(req, res, req.body);
+     await transport.handleRequest(req, res, await c.req.json());
      res.on('close', () => {
        console.log('请求关闭');
        transport.close();
        server.close();
      });
+     return toFetchResponse(res);
    } catch (error) {

使用示例 MCP 客户端测试

在第一个终端中：

npm start

在第二个终端中：

node node_modules/@modelcontextprotocol/sdk/dist/esm/examples/client/simpleStreamableHttp.js

这将尝试连接到运行在 3000 端口的 MCP 服务器。你可以使用 connect <url>/mcp 来连接不同的主机或端口。

然后你可以运行命令如 list-prompts 或 list-tools 验证你的 MCP 服务器是否正常工作。

部署

npm run deploy

以下是针对部署在 Cloudflare Workers 上的 Hono MCP 服务器的一个示例会话：

> connect https://mcp-hono-stateless.michael.workers.dev/mcp
正在连接到 https://mcp-hono-stateless.michael.workers.dev/mcp...
创建传输通道，会话 ID: undefined
已连接到 MCP 服务器

> list-tools
可用工具：
  - start-notification-stream: 开始发送周期性通知以测试重连功能

> list-prompts
可用提示：
  - greeting-template: 简单的问候提示模板

> call-tool start-notification-stream
调用工具 'start-notification-stream'，参数：{}

通知 #1: info - 周期性通知 #1 于 2025-04-27 16:31:00
通知 #2: info - 周期性通知 #2 于 2025-04-27 16:31:10
...
工具结果：
  已开始每 100ms 发送一次周期性通知