AI导哈

时间协议服务器

一个提供时间和时区转换功能的模型上下文协议服务器，支持获取当前时间信息和时区转换。

  • by fisher1006
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 fisher1006/time-mcp

使用说明

时间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服务器时间.

使用PIP

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

pip install mcp-server-time

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

python -m mcp_server_time

配置

为Claude.app进行配置

添加到您的Claude设置中：

Using uvx 
"mcpServers": {
  "time": {
    "command": "uvx",
    "args": ["mcp-server-time"]
  }
}
Using docker 
"mcpServers": {
  "time": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "mcp/time"]
  }
}
Using pip installation 
"mcpServers": {
  "time": {
    "command": "python",
    "args": ["-m", "mcp_server_time"]
  }
}

为Zed配置

添加到您的Zed settings.json：

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

自定义-系统时区

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

例子：

{
  "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
}
  1. 在时区之间转换时间：
{
  "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

给克劳德的问题示例

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

构建

Docker构建：

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

贡献

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

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

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

许可证

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

相关 MCP