
MCP Server transport for Hono applications

2025.04.07
3
TypeScript传输层实现实时通信开发效率
hono-mcp-server-sse-transport 是一个为 Hono 应用提供的 MCP Server 传输层实现。它解决了在使用 Hono 框架时,与 MCP Server 连接的问题,特别是在官方 TypeScript SDK 不完全支持 Hono 的情况下。该项目的核心功能包括提供 SSE(Server-Sent Events)传输支持,使得 Hono 应用能够与 MCP Server 进行实时通信。
View on GitHub
Overview
基本能力
产品定位
hono-mcp-server-sse-transport 是一个为 Hono 应用提供的 MCP Server 传输层实现,用于解决 Hono 与 MCP Server 连接的问题。
核心功能
- 提供 SSE(Server-Sent Events)传输支持,实现 Hono 应用与 MCP Server 的实时通信。
- 支持多路复用连接,通过 sessionId 管理多个传输实例。
- 提供简单的 API 接口,便于集成到现有 Hono 应用中。
适用场景
- 需要在 Hono 应用中与 MCP Server 进行实时通信的场景。
- 官方 TypeScript SDK 不完全支持 Hono 时的替代方案。
工具列表
SSETransport
: 提供 SSE 传输支持,管理连接会话。McpServer
: 用于创建和管理 MCP Server 实例。
常见问题解答
- 问题:为什么在 Hono 中使用官方 SDK 时无法正常工作? 解答:因为官方 SDK 不完全支持 Hono,特别是在响应头处理上存在问题。
- 问题:如何管理多个连接? 解答:通过 sessionId 在 transports 对象中管理多个传输实例。
使用教程
使用依赖
确保已安装 Node.js 和 pnpm。
安装教程
pnpm add -D hono-mcp-server-sse-transport
调试方式
- 启动服务后,访问
/sse
端点建立 SSE 连接。 - 使用
/messages
端点发送消息,确保传输正常工作。 - 检查控制台日志,确认连接和消息传输状态。
示例调试命令:
curl http://localhost:3000/sse