HUMMBL MCP 服务器

关键词

模型框架工具注册资源管理JSON-RPCLLM 集成

使用说明（Markdown 格式）

项目简介

  • 该项目实现了一个基于 MCP 的后端服务器，专门为大语言模型（LLM）提供统一的上下文服务。它可以托管资源、注册并执行工具、定义并渲染提示模板，并通过 JSON-RPC 与客户端进行通信。服务器还实现了会话管理、能力声明，以及对多种传输协议的支持（当前实现以标准输入输出为入口，未来可扩展为 SSE、WebSocket 等）。

主要功能点

  • MCP 服务器核心：构建并暴露一个 MCP 服务器实例，注册丰富的工具集合、资源端点，支持多种交互模式。
  • 资源管理：提供对模型、变换、方法论等资源的直接访问，方便 LLM 调用时获取上下文信息。
  • 工具注册与调用：注册覆盖模型信息、变换、问题模式、工作流等领域的工具，支持输入输出的严格校验与结构化返回。
  • Prompts 与模板：提供用于对话与分析的提示模板和方法，便于 LLM 的交互设计。
  • 数据接口与存储：集成 D1、Redis 等存储解决方案，支持持久化与快速缓存。
  • 会话与安全：内置会话管理、鉴权（API Key）、日志、指标等观测能力，确保安全可控的访问与使用。
  • 开发与测试友好：包含完整的单元测试覆盖、TypeScript 强类型、Railway-like 的 Result 模式等。

安装步骤

  • 确保环境中已安装 Node.js。
  • 下载安装包并安装依赖：
    • 通过全局安装方式：npm install -g @hummbl/mcp-server
    • 或直接使用 npx 启动：npx @hummbl/mcp-server
  • 本地运行方式（开发环境）：
    • 克隆仓库后进入目录，执行 npm install
    • 运行开发服务器：npm run dev

服务器配置（供 MCP 客户端使用的连接配置）

  • 说明：MCP 客户端需要知道如何启动并连接到 MCP 服务器。本实现推荐的客户端连接信息如下（以 JSON 表述，非代码示例，便于直观配置）： { "serverName": "hummbl-mcp-server", "command": "npx", "args": ["-y", "@hummbl/mcp-server"], "description": "HUMMBL MCP 服务器，用于向 LLM 客户端提供资源、工具和提示模板的上下文服务", "transport": "stdio", "notes": "使用标准输入输出（stdio）作为 MCP 协议传输入口，后续可扩展为 SSE/WebSocket 等传输方式" } 说明：
  • serverName 对应服务器的名称，用于在客户端配置中标识。
  • command 与 args 为启动 MCP 服务器的命令和参数，客户端将通过该命令启动服务器并建立连接。
  • transport 标识传输协议（此实现默认 stdio，未来可扩展为其他传输）。
  • description 用于对接的描述信息，便于运营与维护。

基本使用方法

  • 项目目标：通过 MCP 客户端（如 Claude Desktop 等）以标准化的 JSON-RPC 请求方式访问服务器提供的资源、工具和 Prompts。
  • 主要步骤：
    1. 启动服务器：按照服务器配置中的启动命令在合适的环境中启动 MCP 服务器。
    2. 客户端连接：客户端通过指定的传输通道（当前为 stdio）与服务器建立通信。
    3. 调用资源与工具：通过 JSON-RPC 请求读取资源、执行工具、获取变换信息等。
    4. 渲染 Prompt 与模板：使用服务器提供的 Prompts 与模板进行 LLM 交互。
    5. 会话与安全：使用 Key 验证、会话跟踪与观测指标保障安全可控的访问。
  • 注意事项：
    • 如需在 Claude Desktop 中使用，请按照 README 给出的 Claude Desktop 配置示例，将启动命令及参数填入客户端配置中。
    • 如要扩展传输协议，请参考代码结构中的 server 配置与传输入口，未来可接入 SSE、WebSocket 等。

关键词 模型框架, 工具注册, 资源管理, JSON-RPC, LLM 集成

分类ID 6

服务器信息

访问项目