Time MCP Server

提供时间和时区转换功能的Model Context Protocol服务器。此服务器使LLMs能够获取当前时间信息，并使用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。

使用PIP

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

pip install mcp-server-time

安装后，你可以使用以下命令作为脚本运行它：

python -m mcp_server_time

配置

针对Claude.app配置

在你的Claude设置中添加：

<details> <summary>使用uvx</summary>

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

</details> <details> <summary>使用docker</summary>

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

</details> <details> <summary>使用pip安装</summary>

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

</details>

针对Zed配置

在你的Zed settings.json中添加：

<details> <summary>使用uvx</summary>

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

</details> <details> <summary>使用pip安装</summary>

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

</details>

针对VS Code配置

为了快速安装，请使用下面的一个一键安装按钮...

对于手动安装，请在VS Code的用户设置（JSON）文件中添加以下JSON块。你可以通过按Ctrl + Shift + P并键入Preferences: Open User Settings (JSON)来完成此操作。

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

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

<details> <summary>使用uvx</summary>

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

</details> <details> <summary>使用Docker</summary>

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

</details>

针对Zencoder配置

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

<details> <summary>使用uvx</summary>

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

</details>

自定义 - 系统时区

默认情况下，服务器会自动检测系统的时区。你可以通过在配置中的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检查器来调试服务器。对于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许可证授权。这意味着你可以自由使用、修改和分发该软件，但须遵守MIT许可证的条款和条件。更多详情，请参阅项目存储库中的LICENSE文件。