MCP Hono Stateless

🚀 無狀態 Hono MCP 服務器

這是一個基於 Hono 的 MCP 服務器示例，利用 Streamable HTTP 技術構建。它參考官方的 Express 示例 simpleStatelessStreamableHttp.ts 進行開發，並使用 fetch-to-node 完成轉換。該服務器可部署到 Cloudflare Workers 以及其他支持 Hono 的環境中。

✨ 主要特性

• 基於 Hono 框架，具備高效的性能和簡潔的開發體驗。
• 採用 Streamable HTTP，實現流式數據處理。
• 可方便地部署到 Cloudflare Workers 及其他支持 Hono 的環境。

📦 安裝指南

本項目未明確給出安裝步驟，若需使用，可參考以下通用步驟：

1. 克隆項目倉庫：

git clone https://github.com/mhart/mcp-hono-stateless.git
cd mcp-hono-stateless

2. 安裝依賴：

npm install

💻 使用示例

基礎用法

在第一個終端中啟動服務器：

npm start

在第二個終端中使用 MCP 客戶端進行測試：

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

這將嘗試連接到運行在 3000 端口的 MCP 服務器。你可以使用 connect <url>/mcp 來連接不同的主機或端口。

高級用法

啟動服務器並連接成功後，你可以運行命令如 list-prompts 或 list-tools 驗證你的 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 發送一次週期性通知

🔧 技術細節

該項目與 Express 示例的主要區別在於使用了 Hono 框架替代 Express，並且使用 fetch-to-node 進行轉換。以下是關鍵代碼的對比：

- 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) {

🚀 部署

在項目根目錄下運行以下命令進行部署：

npm run deploy

這將把項目部署到 Cloudflare Workers 上。