Utils MCP 服务端

关键词

AI context servicetool registryJSON-RPC backendMCP over HTTPcontext provisioning

使用说明（简明易懂的使用步骤和要点）

  • 项目简介
    • 该仓库实现了一个 MCP 服务器端，用于向大语言模型客户端提供可执行的工具、资源和提示模板等上下文服务，采用无状态的 HTTP 传输方式，通过 /mcp 提供 MCP API。
  • 主要功能点
    • MCP 服务器核心：实现 MCP 的请求/响应处理，支持工具注册、请求分发和结果返回。
    • 工具注册与执行：注册多种工具（如哈希、JWT 解码、时间转换、CRON 描述等），LLM 客户端可调用这些工具并获取结构化返回。
    • 路由与传输：使用 Express 提供 /mcp 入口，采用无状态的 HTTP 传输来处理 MCP 请求。
    • 会话与并发：为多客户端场景设计，与 MCP 的并发要求兼容，避免跨请求的 ID 冲突。
    • 其他实用工具与 API：项目还包含多种辅助工具的 REST API 和示例页面。
  • 安装步骤
    • 安装依赖：在项目根目录执行 npm install。
    • 启动服务：执行 npm start，默认会在端口 5000 启动。
    • 访问 MCP 端点：打开 http://localhost:5000/mcp 即可向 MCP 客户端提供服务。
    • 可选：如需通过 MCP Inspector、VSCode、Claude 等集成，确保 MCP 服务可通过上面的端点和端口对外暴露。
  • 服务器配置（MCP 客户端需要的启动配置，JSON 格式）
    • MCP 客户端需要的最小信息：服务器名称、启动命令及参数。示例结构如下，请按实际环境替换路径和端口等： { "server_name": "utils-mcp-server", "command": "node", "args": ["mcp_server.js"], "env": { "PORT": "5000" }, "cwd": "/path/to/utils" }
    • 说明：
      • server_name: 客户端内部标识名称，建议与实际服务器一致。
      • command: 启动 MCP 服务器的命令，这里为 node。
      • args: 启动命令的参数，指向用于创建 MCP 服务的脚本（此处为 mcp_server.js）。
      • env: 运行时环境变量（如端口等配置）。
      • cwd: 启动进程的工作目录，请设为仓库根目录或实际部署目录。
  • 基本使用方法
    • 通过 MCP Inspector、VSCode、Claude 等工具接入：在工具中配置服务器地址为 http://localhost:5000/mcp（若使用不同端口，请相应调整）。
    • 调用工具：LLM 客户端通过 MCP 端点请求已注册的工具（如哈希、JWT 解码、时间转换等），获取结构化的返回内容并用于后续对话或自动化任务。
    • 服务器工作模式：保持无状态 HTTP 传输，服务器会为每次请求创建独立的处理环境，确保并发场景下的请求隔离性。

服务器信息

访问项目