AI导哈

无状态Hono MCP服务器

一个基于Hono框架的无状态MCP服务器示例，使用可流式HTTP，可部署到Cloudflare Workers等支持Hono的环境。

  • by mhart
  • TypeScript
  • 本地部署
  • 102 星标
  • 更新于
在 GitHub 查看 mhart/mcp-hono-stateless

使用说明

无状态Hono MCP服务器

一个例子 荣誉 基于Streamable HTTP的MCP服务器 官方Express示例, 使用 获取到节点 转换、部署到 Cloudflare员工 （以及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('Request closed');
        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
Connecting to https://mcp-hono-stateless.michael.workers.dev/mcp...
Transport created with session ID: undefined
Connected to MCP server

> list-tools
Available tools:
  - start-notification-stream: Starts sending periodic notifications for testing resumability

> list-prompts
Available prompts:
  - greeting-template: A simple greeting prompt template

> call-tool start-notification-stream
Calling tool 'start-notification-stream' with args: {}

Notification #1: info - Periodic notification #1 at 2025-04-22T16:20:50.178Z
>
Notification #2: info - Periodic notification #2 at 2025-04-22T16:20:50.278Z
>
Notification #3: info - Periodic notification #3 at 2025-04-22T16:20:50.378Z
>
Notification #4: info - Periodic notification #4 at 2025-04-22T16:20:50.478Z
>
Notification #5: info - Periodic notification #5 at 2025-04-22T16:20:50.578Z
>
Notification #6: info - Periodic notification #6 at 2025-04-22T16:20:50.678Z
>
Notification #7: info - Periodic notification #7 at 2025-04-22T16:20:50.778Z
>
Notification #8: info - Periodic notification #8 at 2025-04-22T16:20:50.878Z
>
Notification #9: info - Periodic notification #9 at 2025-04-22T16:20:50.978Z
>
Notification #10: info - Periodic notification #10 at 2025-04-22T16:20:51.078Z
> Tool result:
  Started sending periodic notifications every 100ms

相关 MCP