Time MCP Server

🚀 时间 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 时区名称

示例问题

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

📚 详细文档

配置指南

对于 Claude.app

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

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

对于 Zee

1. 将服务器文件夹添加到 src 目录。
2. 在 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 文件。