用于 Hono 应用的 MCP Server 传输

概述

此项目为需要连接到 MCP Server 的 Hono 应用程序提供了一个传输层。官方 TypeScript SDK 旨在与 express 一起使用。 如果您尝试按照他们的说明进行操作，但将 express 替换为 hono，您会发现它不起作用。即使您将 HttpBinding 设置为环境变量（请参阅 @hono/node-server 中的示例）， 它仍然不起作用，因为某些标头在发送响应后才被添加到响应中。

此实现受到以下拉取请求的启发。

在官方 SDK 中对 Hono 提供适当的支持之前，您可以使用此传输层。

开始使用

安装

pnpm add -D hono-mcp-server-sse-transport

用法

import { Hono } from 'hono';
import { serve } from '@hono/node-server';
import { streamSSE } from 'hono/streaming';
import { SSETransport } from 'hono-mcp-server-sse-transport';
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';

const mcpServer = new McpServer(
  {
    name: 'your-mcp-server-name',
    version: '1.0.0',
  },
  {
    capabilities: {
      tools: {},
    },
  },
);

// 在这里添加你的工具
// ...

const app = new Hono();

// 为了支持多个同时连接，我们有一个从
// sessionId 到 transport 的查找对象
const transports: { [sessionId: string]: SSETransport } = {};

app.get('/sse', (c) => {
  return streamSSE(c, async (stream) => {
    const transport = new SSETransport('/messages', stream);

    transports[transport.sessionId] = transport;

    stream.onAbort(() => {
      delete transports[transport.sessionId];
    });

    await mcpServer.connect(transport);

    while (true) {
      // 这将保持连接活动
      // 您也可以等待一个永远不会 resolve 的 promise
      await stream.sleep(60_000);
    }
  });
});

app.post('/messages', async (c) => {
  const sessionId = c.req.query('sessionId');
  const transport = transports[sessionId];

  if (transport == null) {
    return c.text('No transport found for sessionId', 400);
  }

  return transport.handlePostMessage(c);
});

serve(
  {
    fetch: app.fetch,
    port: 3000,
  },
);