MCP 时间服务器示例 (MCP Time Server Demo)

MCP 时间服务器示例 (MCP Time Server Demo)

site icon
2025.04.22 0
TypeScript时间服务其它
MCP 时间服务器示例是一个基于模型上下文协议 (MCP) 的服务器示例,使用 TypeScript 和 `@modelcontextprotocol/sdk` 构建。它提供了一个工具,用于获取当前时间,并可以选择性地指定时区。
View on GitHub

Overview

基本能力

产品定位

MCP 时间服务器示例是一个基于模型上下文协议 (MCP) 的服务器示例,主要用于提供时间服务。

核心功能

  • getCurrentTime 工具: 获取当前时间。
  • 支持可选的 timezone 参数 (IANA 时区标识符,例如 America/New_York, Asia/Shanghai)。
  • 如果未提供时区或时区无效,则返回服务器本地时间。
  • MCP 兼容: 可以与任何支持 MCP 的客户端(如 Claude Desktop 或 MCP Inspector)集成。
  • 基于 Stdio: 使用标准输入/输出进行通信,易于集成。

适用场景

  • 需要获取当前时间的应用或服务。
  • 需要支持多时区时间查询的应用或服务。
  • 需要与 MCP 兼容的客户端集成的应用或服务。

工具列表

  • getCurrentTime 工具: 获取当前时间,支持可选的时区参数。

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

  • Node.js (建议使用 LTS 版本)
  • npm (通常随 Node.js 一起安装)

安装教程

  1. 克隆或下载此仓库。
  2. 在项目根目录打开终端,运行以下命令安装依赖项: bash npm install

调试方式

  1. 编译项目: bash npm run build
  2. 运行服务器: bash npm start
  3. 使用 MCP Inspector 测试:
  4. 下载并安装 MCP Inspector
  5. 启动 MCP Inspector。
  6. 在 MCP Inspector 中创建一个新的 MCP 会话。
  7. 在 MCP Inspector 中,选择 Tools -> Import Tool,然后选择 tools/getCurrentTime.ts
  8. 点击 Import 按钮,然后在 Tools 列表中找到 getCurrentTime 工具。
  9. 点击 getCurrentTime 工具,然后点击 Run 按钮。
  10. 查看输出结果。

许可证

该项目遵循 None 开源许可条款。