hono-mcp-server

关键词

Hono API上下文服务JSON-RPC工具注册Prompt 模板

使用说明（Markdown 格式）

  • 项目简介

    • hono-mcp-server 旨在把 Hono API 暴露为 MCP（Model Context Protocol）服务端能力，核心能力包括：托管与管理 Resources（资源/数据访问）、注册与执行 Tools（工具/外部功能调用）、定义与渲染 Prompt 模板，并通过 JSON-RPC 与 LLM 客户端进行请求与响应交互。服务器端负责会话、能力声明与对外暴露的接口设计，支持多种传输协议以适配不同的客户端场景。

  • 主要功能点

    • MCP 核心能力暴露：通过一个后端 MCP 服务器，统一管理资源、工具和提示模板，提供给 LLM 客户端使用。
    • 工具注册与执行：将 Hono 的 API 端点注册为 MCP Tool，LLM 可以通过工具调用外部功能。
    • Prompt 模板定义与渲染：定义可定制的 Prompt 模板，支持不同的交互模式与渲染策略。
    • JSON-RPC 通信：服务器侧实现对客户端的 JSON-RPC 请求/响应处理，支持标准的请求格式和通知。
    • 会话管理与能力声明：服务器维护会话上下文，并对外声明自身能力，便于客户端对接与协商。
    • 多传输协议支持：理论上支持 Stdio/SSE/WebSocket 等传输层，满足不同部署环境的需求。

  • 安装步骤

      1. 克隆仓库到本地或服务器环境。
      1. 安装依赖（如使用 npm：npm install）。
      1. 构建并启动服务（根据仓库实际命令可执行构建与启动，例如“npm run build”后启动服务器进程）。
      1. 服务启动后，服务器将对外提供 MCP JSON-RPC 接口，客户端可通过相应的连接方式进行交互。

  • 服务器配置（MCP 客户端需要的启动信息） 配置示例（JSON 形式，描述服务器名称、启动命令及参数）： { "server_name": "Hono MCP Server", "command": "node", "args": ["dist/index.js"], "description": "启动 hono-mcp-server，提供 MCP 服务供 LLM 客户端连接与调用工具/资源" } 配置字段说明：

    • server_name: MCP 服务器的展示名称，便于管理与识别。
    • command: 启动服务器所执行的主命令（如 Node 运行入口）。
    • args: 启动命令的参数（如进入编译输出目录下的入口脚本路径）。
    • description: 对该服务器的简要描述，便于理解该服务器的用途。

  • 基本使用方法

    • 启动后，MCP 客户端通过 JSON-RPC 与服务器建立连接。
    • 客户端可以读取并管理 Resources（数据资源）、注册 Tools（端点工具）以及获取/渲染 Prompts（提示模板）。
    • 客户端发起请求时，按 MCP 的 JSON-RPC 规范发送请求，服务器返回标准的 JSON-RPC 响应或通知。
    • 如需查看示例用法，可参考仓库中的实例代码（examples/basic 与 codemode 示例），了解如何通过 mcp/app 的封装暴露 API 并注册工具。

服务器信息

访问项目