使用说明

• 项目简介
  • 该仓库包含一系列基于 MCP（Model Context Protocol）的服务器实现模板，核心通过 MCP SDK 构建，并以不同传输方式暴露工具（Tools）、资源（Resources）以及可渲染的 Prompt 模板，面向 LLM 客户端提供上下文服务。
  • 典型示例包括 DateTime、Calculator 等工具服务，使用 @modelcontextprotocol/sdk 提供的 MCP 服务器框架进行工具注册并在标准传输通道上暴露输出。
• 主要功能点
  • 支持 MCP 的核心能力：注册工具、处理请求、返回 JSON-RPC 兼容响应、对输出进行结构化封装。
  • 提供多个示例工具实现，如 DateTime/Calculator，支持格式化日期、时间、计算表达式等常用功能。
  • 通过 MCP SDK 的 StdioServerTransport (标准输入输出) 启动服务，便于在设备或容器中以管道形式运行。
  • 易于将模板扩展为更多 MCP 工具，支持在模板目录中新增工具实现。
• 安装步骤
  • 安装 Node.js 环境（需具备运行 MCP 服务所需的运行时）。
  • 在模板文件所在位置执行依赖安装（如 npm install），确保 MCP SDK 及相关依赖可用。
  • 以模板为起点启动服务器，例如通过 Node 直接执行相应模板脚本（如 datetime 或 calculator 模板），服务器将输出工具结果并接收相应的 MCP 请求。
• 服务器配置（供 MCP 客户端使用的启动信息）
  • MCP 客户端需要配置一个 MCP 服务器来对接，示例配置要点如下（以文本描述，不含代码块）：
    • server name: DateTime（或 Calculator 等模板中的名称）
    • command: node
    • args: 路径到对应模板脚本，例如 "./templates/default/mcpServers/datetime.js" 或 "./templates/default/mcpServers/calculator.js"
  • 说明：MCP 客户端在连接时需要读取该配置信息，以便知道要启动哪个服务器、使用哪种传输协议（此处模板默认使用 stdio），以及服务器暴露的工具名称及其输入参数规范。
• 基本使用方法
  • 启动服务器：按照上述方式在目标环境中启动模板对应脚本，服务器将通过标准输出/输入与 MCP 客户端通信。
  • 使用工具：通过 MCP 客户端调用注册的工具（如获取当前日期/时间、进行日期格式化、执行 JavaScript 表达式等），服务器将返回结构化结果（JSON 字符串或文本块）。
  • 扩展性：若需要新增工具，可在 templates 目录下复制现有模板并实现新的 tool，随后在新模板中注册该工具即可。