time-mcp-server

Time MCP 服务

一个提供时间和时区转换功能的 Model Context Protocol 服务。此服务可让大模型获取当前时间信息，并使用 IANA 时区名称进行时区转换，同时自动检测系统时区。

可用工具

• 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。

uvx mcp-server-time

使用 PIP

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

pip install mcp-server-time

安装后，你可以将其作为脚本运行：

python -m mcp_server_time

配置

为 Claude.app 配置

添加到你的 Claude 设置中：

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time"]
    }
  }
}

{
  "mcpServers": {
    "time": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "LOCAL_TIMEZONE", "mcp/time"]
    }
  }
}

{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "mcp_server_time"]
    }
  }
}

为 Zed 配置

添加到你的 Zed settings.json：

"context_servers": [
  "mcp-server-time": {
    "command": "uvx",
    "args": ["mcp-server-time"]
  }
],

"context_servers": {
  "mcp-server-time": {
    "command": "python",
    "args": ["-m", "mcp_server_time"]
  }
},

为 VS Code 配置

如需快速安装，请使用下方的一键安装按钮之一……

如需手动安装，请将以下 JSON 代码块添加到 VS Code 中的 User Settings (JSON) 文件。你可以按 Ctrl + Shift + P 并输入 Preferences: Open User Settings (JSON) 来完成此操作。

你也可以选择将其添加到工作区中名为 .vscode/mcp.json 的文件。这可以让你与他人共享配置。

请注意，使用 mcp.json 文件时需要 mcp 键。

{
  "mcp": {
    "servers": {
      "time": {
        "command": "uvx",
        "args": ["mcp-server-time"]
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "time": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/time"]
      }
    }
  }
}

为 Zencoder 配置

1. 前往 Zencoder 菜单（……）
2. 从下拉菜单中选择 Agent Tools
3. 点击 Add Custom MCP
4. 添加下方的名称和服务配置，并确保点击 Install 按钮

{
    "command": "uvx",
    "args": ["mcp-server-time"]
  }

默认情况下，服务会自动检测系统时区。你可以在配置的 args 列表中添加参数 --local-timezone 来覆盖此设置。

示例：

{
  "command": "python",
  "args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
}

交互示例

1. 获取当前时间：

{
  "name": "get_current_time",
  "arguments": {
    "timezone": "Europe/Warsaw"
  }
}

响应：

{
  "timezone": "Europe/Warsaw",
  "datetime": "2024-01-01T13:00:00+01:00",
  "is_dst": false
}

2. 转换不同时区的时间：

{
  "name": "convert_time",
  "arguments": {
    "source_timezone": "America/New_York",
    "time": "16:30",
    "target_timezone": "Asia/Tokyo"
  }
}

响应：

{
  "source": {
    "timezone": "America/New_York",
    "datetime": "2024-01-01T12:30:00-05:00",
    "is_dst": false
  },
  "target": {
    "timezone": "Asia/Tokyo",
    "datetime": "2024-01-01T12:30:00+09:00",
    "is_dst": false
  },
  "time_difference": "+13.0h",
}

调试

你可以使用 MCP inspector 调试服务。对于 uvx 安装：

npx @modelcontextprotocol/inspector uvx mcp-server-time

或者，如果你已将软件包安装到特定目录，或正在开发该软件包：

cd path/to/servers/src/time
npx @modelcontextprotocol/inspector uv run mcp-server-time

Claude 问题示例

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

欢迎提交拉取请求！欢迎贡献新想法、错误修复或改进，让 mcp-server-time 更强大、更实用。

许可证

mcp-server-time 使用 MIT License 许可。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT License 的条款和条件。更多详情请参阅项目仓库中的 LICENSE 文件。