Back to MCP directory
publicPublicdnsLocal runtime

time

一个提供时间和时区转换功能的MCP服务器,支持自动检测系统时区和IANA时区名称转换。

article

README

🚀 时间 MCP 服务器

时间 MCP 服务器是一个基于模型上下文协议(Model Context Protocol)的服务器,它提供时间和时区转换功能。借助该服务器,大型语言模型(LLMs)能够获取当前时间信息,并使用 IANA 时区名称进行时区转换,同时支持自动检测系统时区。

🚀 快速开始

时间 MCP 服务器提供了一系列工具,可帮助您轻松获取和转换时间。以下是可用工具的介绍:

  • get_current_time - 获取特定时区或系统时区的当前时间。

    • 必需参数:
      • timezone (字符串):IANA 时区名称(例如 'America/New_York','Europe/London')
  • convert_time - 在不同时区之间转换时间。

    • 必需参数:
      • source_timezone (字符串):源 IANA 时区名称
      • time (字符串):24 小时制时间格式(HH:MM)
      • target_timezone (字符串):目标 IANA 时区名称

📦 安装指南

使用 uv(推荐)

当使用 uv 时,无需进行任何特定安装。我们将直接使用 uvx 运行 mcp-server-time

使用 PIP

您也可以通过 pip 安装 mcp-server-time

pip install mcp-server-time

安装完成后,您可以将其作为脚本运行:

python -m mcp_server_time

📚 详细文档

为 Claude.app 配置

您可以将以下配置添加到您的 Claude 设置中:

使用 uvx
"mcpServers": {
  "time": {
    "command": "uvx",
    "args": ["mcp-server-time"]
  }
}
使用 docker
"mcpServers": {
  "time": {
    "command": "docker",
    "args": ["run", "mcp/time"]
  }
}

为本地开发配置

将以下内容添加到 ~/.config/uv/servers.json

{
  "servers": {
    "time": {
      "implementation": "local",
      "command": "node",
      "args": ["src/time/index.js"]
    }
  }
}

💻 使用示例

以下是一些使用时间 MCP 服务器的示例问题:

  1. “现在是什么时间?”(将使用系统时区)
  2. “东京的时间是几点?”
  3. “当纽约是下午4点时,伦敦是什么时候?”
  4. “把东京时间上午9:30转换成纽约时间”

🛠️ 开发构建

您可以使用 Docker 进行构建:

cd src/time
docker build -t mcp/time .

🤝 贡献

我们热烈欢迎任何形式的贡献,以帮助扩展和改进 mcp-server-time。无论是添加新的时间相关工具、增强现有功能,还是改进文档,您的意见都非常宝贵。

有关其他 MCP 服务器和实现模式的示例,请参见: https://github.com/modelcontextprotocol/servers

我们欢迎您提交 Pull Request!请随时为 mcp-server-time 贡献新想法、修复错误或进行功能增强,让它变得更加强大和实用。

📄 许可证

mcp-server-time 采用 MIT License 许可。这意味着您可以自由使用、修改和分发该软件,但需遵守 MIT 许可证的条款和条件。有关详细信息,请参见项目存储库中的 LICENSE 文件。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client