JinDaGe - time-mcp-server MCP Details

article

README

🚀 时间 MCP 服务器

时间 MCP 服务器是一个基于 Model Context Protocol 的服务器，它提供了时间和时区转换功能。借助该服务器，LLM 能够轻松获取当前时间信息，并利用 IANA 时区名称进行时区转换，同时还支持自动检测系统时区。

✨ 主要特性

提供 get_current_time 和 convert_time 两个实用工具，满足不同的时间查询和转换需求。
支持自动检测系统时区，也可在配置中自定义本地时区。
支持多种安装方式，包括使用 uv 和通过 pip 安装。
适用于 Claude.app 和 Zee 等平台，可通过简单配置进行集成。

📦 安装指南

推荐方法：使用 uv

cd path/to/server/time
uv run mcp-time

替代方法：通过 pip 安装

pip install time-mcp-server
time-mcp-server

💻 使用示例

可用工具

`get_current_time`

此工具用于获取特定时区或系统时区的当前时间。

必要参数：
- timezone (字符串)：IANA 时区名称（例如 'America/New_York'，'Europe/London'）

`convert_time`

该工具用于在不同时区之间转换时间。

必要参数：
- source_timezone (字符串)：源 IANA 时区名称
- time (字符串)：24 小时时制（例如 'HH:MM')
- destination_timezone (字符串)：目标 IANA 时区名称

示例问题

“现在几点了？”（使用系统时区）
“东京时间是几点？”
“纽约下午 4 点时，伦敦是什么时候？”
“将东京时间上午 9:30 转换为纽约时间”

📚 详细文档

配置指南

对于 Claude.app

将服务器文件夹添加到 src 目录。
在 server.json 中注册时区工具：

{
  "tools": {
    "mcp-time": {
      "path": "time/src/server.ts"
    }
  }
}

对于 Zee

将服务器文件夹添加到 src 目录。
在 server.json 中注册时区工具：

{
  "tools": {
    "mcp-time": {
      "path": "time/src/server.ts"
    }
  }
}

自定义设置

可以在配置中指定本地时区，默认情况下会自动检测系统时区。

调试信息

使用 MCP inspector 进行调试。根据文档中的说明，定位到相应目录并运行服务器以进行调试检查。

构建

在服务器文件夹内执行以下命令：

docker build -t mcp/time .

贡献指南

欢迎为 mcp-server-time 做出贡献！无论是添加新功能、修复问题还是改进文档，我们都欢迎您的参与。如需了解其他 MCP 服务器的实现模式，请参考相关项目链接。

📄 许可证

mcp-server-time 采用 MIT 许可证，允许自由使用、修改和分发软件。详细许可内容请参阅项目仓库中的 LICENSE 文件。

time-mcp-server