时间协议服务器

一个提供时间和时区转换功能的模型上下文协议服务器,支持自动检测系统时区和IANA时区名称转换。

  • by CarterPape
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 carterpape/pape-mcp-server-time

使用说明

时间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 直接运行 pape mcp服务器时间.

使用PIP

或者,您可以安装 pape-mcp-server-time 通过pip:

pip install pape-mcp-server-time

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

python -m pape_mcp_server_time

配置

为Claude.app进行配置

添加到您的Claude设置中:

Using uvx
{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["pape-mcp-server-time"]
    }
  }
}
Using pip installation
{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "pape_mcp_server_time"]
    }
  }
}

为Zed配置

添加到您的Zed settings.json:

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

配置VS代码

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

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

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

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

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

自定义-系统时区

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

例子:

{
  "command": "python",
  "args": ["-m", "pape_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 pape-mcp-server-time

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

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

给克劳德的问题示例

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

贡献

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

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

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

许可证

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