MCP Server transport for Hono applications

MCP Server transport for Hono applications

site icon
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

调试方式

  1. 启动服务后,访问 /sse 端点建立 SSE 连接。
  2. 使用 /messages 端点发送消息,确保传输正常工作。
  3. 检查控制台日志,确认连接和消息传输状态。

示例调试命令:

curl http://localhost:3000/sse

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。