MCP Hono Stateless

🚀 無状態 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

次に、別のターミナルで MCP クライアントを起動します。

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

これにより、3000 ポートで動作している MCP サーバーに接続しようとします。connect <url>/mcp を使用して、異なるホストやポートに接続することもできます。

その後、list-prompts や list-tools などのコマンドを実行して、MCP サーバーが正常に動作していることを確認できます。

📦 デプロイ

以下のコマンドを使用して、Cloudflare Workers などの環境にデプロイできます。

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 ごとに定期的な通知の送信を開始しました