时间MCP服务器

提供时间和时区转换功能的模型上下文协议服务器。此服务器使LLM能够获取当前时间信息，并使用IANA时区名称执行时区转换，并具有自动系统时区检测功能。

可用工具

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

• 必需参数：

• timezone （string）：IANA时区名称（例如，“美国/纽约”、“欧洲/伦敦”）

• convert_time -在时区之间转换时间。

• 必需参数：

• source_timezone （string）：源IANA时区名称

• time （字符串）：24小时格式的时间（HH:MM）

• target_timezone （string）：目标IANA时区名称

安装

使用紫外线（推荐）

使用时 uv 不需要特定的安装。我们将 使用 uvx 直接运行 mcp服务器时间.

BASH``` 1uvx mcp-server-time

### 使用PIP


或者，您可以安装 `mcp-server-time` 通过pip：


BASH```
1pip install mcp-server-time

安装后，您可以使用以下命令将其作为脚本运行：

BASH``` 1python -m mcp_server_time

## 配置


### 为Claude.app进行配置


添加到您的Claude设置中：



Using uvx
JSON```
1
2
3
4
5
6
7
8{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time"]
    }
  }
}

Using docker JSON``` 1 2 3 4 5 6 7 8{ “mcpServers”: { “time”: { “command”: “docker”, “args”: [“run”, “-i”, “—rm”, “-e”, “LOCAL_TIMEZONE”, “mcp/time”] } } }

Using pip installation
JSON```
1
2
3
4
5
6
7
8{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "mcp_server_time"]
    }
  }
}

为Zed配置

添加到您的Zed settings.json：

Using uvx JSON``` 1 2 3 4 5 6”context_servers”: [ “mcp-server-time”: { “command”: “uvx”, “args”: [“mcp-server-time”] } ],

Using pip installation
JSON```
1
2
3
4
5
6"context_servers": {
  "mcp-server-time": {
    "command": "python",
    "args": ["-m", "mcp_server_time"]
  }
},

配置VS代码

为了快速安装，请使用下面的一键安装按钮之一。…

对于手动安装，请将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以按 Ctrl + Shift + P 和打字 Preferences: Open User Settings (JSON).

您可以选择将其添加到名为的文件中 .vscode/mcp.json 在您的工作空间中。这将允许您与他人共享配置。

请注意 mcp 使用时需要密钥 mcp.json 文件。

Using uvx JSON``` 1 2 3 4 5 6 7 8 9 10{ “mcp”: { “servers”: { “time”: { “command”: “uvx”, “args”: [“mcp-server-time”] } } } }

Using Docker
JSON```
1
2
3
4
5
6
7
8
9
10{
  "mcp": {
    "servers": {
      "time": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/time"]
      }
    }
  }
}

配置Zencoder

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

Using uvx JSON``` 1 2 3 4{ “command”: “uvx”, “args”: [“mcp-server-time”] }

### 自定义-系统时区


默认情况下，服务器会自动检测系统的时区。您可以通过添加参数来覆盖此内容 `--local-timezone` 到 `args` 配置中的列表。


例子：


JSON```
1
2
3
4{
  "command": "python",
  "args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
}

交互示例

1. 获取当前时间：

JSON``` 1 2 3 4 5 6{ “name”: “get_current_time”, “arguments”: { “timezone”: “Europe/Warsaw” } }

答复：


JSON```
1
2
3
4
5{
  "timezone": "Europe/Warsaw",
  "datetime": "2024-01-01T13:00:00+01:00",
  "is_dst": false
}

1. 在时区之间转换时间：

JSON``` 1 2 3 4 5 6 7 8{ “name”: “convert_time”, “arguments”: { “source_timezone”: “America/New_York”, “time”: “16:30”, “target_timezone”: “Asia/Tokyo” } }

答复：


JSON```
1
2
3
4
5
6
7
8
9
10
11
12
13{
  "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安装：

BASH``` 1npx @modelcontextprotocol/inspector uvx mcp-server-time

或者，如果您已将软件包安装在特定目录中或正在其上开发：


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

给克劳德的问题示例

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

构建

Docker构建：

BASH``` 1 2cd src/time docker build -t mcp/time .

## 贡献


我们鼓励捐款以帮助延长和改善mcp服务器时间。无论您是想添加新的与时间相关的工具、增强现有功能还是改进文档，您的意见都是有价值的。


有关其他MCP服务器和实现模式的示例，请参阅：
[https://github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)


欢迎拉取请求！请随时贡献新想法、错误修复或增强功能，使mcp服务器时间更加强大和有用。


## 许可证


mcp服务器时间根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。