UTC时间服务器

一个简单可靠的MCP服务器,通过多个验证源提供准确的UTC时间,支持多种格式输出,开箱即用。

  • by very99
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 very99/getutc-mcp

使用说明

GetUTC MCP服务器

英语 | 中文


英语

一个简单可靠的MCP(模型上下文协议)服务器,提供来自多个验证源的准确UTC时间。开箱即用-只需克隆和配置!

✨ 特性

  • 多个时间源:已通过4个可靠来源的准确性验证
    • WorldClockAPI(JSON API)
    • 来自WorldClock、Google和GitHub的HTTP日期标头
  • 多种格式:ISO,时间戳,可读,仅限日期,仅限时间
  • 预建:无需编译即可使用
  • 可靠的:源之间的自动回退

🚀 快速开始

  1. 克隆存储库

    git clone https://github.com/very99/getutc-mcp.git
    cd getutc-mcp
    
  2. 配置您的MCP客户端

    添加到MCP配置文件中:

    适用于Amazon Q CLI (~/.aws/amazonq/mcp.json):

    {
      "mcpServers": {
        "getutc": {
          "command": "node",
          "args": ["/path/to/getutc-mcp/dist/index.js"],
          "timeout": 30000
        }
      }
    }
    

    适用于克劳德桌面 (~/Library/Application Support/Claude/claude_desktop_config.json 在 macOS 上:

    {
      "mcpServers": {
        "getutc": {
          "command": "node",
          "args": ["/path/to/getutc-mcp/dist/index.js"]
        }
      }
    }
    
  3. 开始使用

    询问您的MCP客户:

    • “当前UTC时间是多少?”
    • “获取UTC时间戳”
    • “显示今天的日期”

📖 工具参考

工具名称: get_utc_time

参数:

  • format (可选):输出格式
    • "iso" (默认):ISO 8601格式(2025-06-21T16:18:14.000Z)
    • "timestamp":Unix时间戳(1734789494)
    • "readable":人类可读(2025年6月21日星期六下午4:18:14 UTC)
    • "date-only":仅日期(2025-06-21)
    • "time-only":只有时间(16:18:14)

🔧 需求

  • Node.js(版本14或更高)
  • MCP兼容客户端(Amazon Q CLI、Claude Desktop等)

📁 项目结构

getutc-mcp/
├── dist/           # Pre-built files (ready to use)
│   └── index.js    # Main server file
├── src/            # Source code
├── package.json    # Dependencies
└── README.md       # This file

🤝 贡献

请随时提交问题和拉取请求!

📄 许可证

MIT许可证


中文

一个简单可靠的 MCP (Model Context Protocol) 服务器,通过多个验证源提供准确的 UTC 时间。开箱即用 - 只需克隆和配置!

✨ 特性

  • 多时间源: 通过4个可靠源验证确保准确性
    • WorldClockAPI(JSON API)
    • 世界时钟、谷歌、GitHub的 HTTP日期头
  • 多种格式: ISO、时间戳、可读格式、仅日期、仅时间
  • 预编译: 无需编译即可使用
  • 可靠性: 源之间自动故障转移

🚀 快速开始

  1. 克隆仓库

    git clone https://github.com/very99/getutc-mcp.git
    cd getutc-mcp
    
  2. 配置你的 MCP 客户端

    添加到你的 MCP 配置文件:

    亚马逊Q CLI (~/.aws/amazonq/mcp.json):

    {
      "mcpServers": {
        "getutc": {
          "command": "node",
          "args": ["/path/to/getutc-mcp/dist/index.js"],
          "timeout": 30000
        }
      }
    }
    

    克劳德桌面 (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

    {
      "mcpServers": {
        "getutc": {
          "command": "node",
          "args": ["/path/to/getutc-mcp/dist/index.js"]
        }
      }
    }
    
  3. 开始使用

    询问你的 MCP 客户端:

    • "现在的UTC时间是多少?"
    • "获取UTC时间戳"
    • "显示今天的日期"

📖 工具参考

工具名称: get_utc_time

参数:

  • format (可选): 输出格式
    • "iso" (默认): ISO 8601 格式 (2025-06-21T16:18:14.000Z)
    • "timestamp": Unix 时间戳 (1734789494)
    • "readable": 人类可读格式 (Saturday, June 21, 2025 at 4:18:14 PM UTC)
    • "date-only": 仅日期 (2025-06-21)
    • "time-only": 仅时间 (16:18:14)

🔧 系统要求

  • Node.js (版本 14 或更高)
  • 兼容 MCP 的客户端 (Amazon Q CLI, Claude Desktop 等)

📁 项目结构

getutc-mcp/
├── dist/           # 预编译文件 (可直接使用)
│   └── index.js    # 主服务器文件
├── src/            # 源代码
├── package.json    # 依赖项
└── README.md       # 本文件

🤝 贡献

欢迎提交问题和拉取请求!

📄 许可证

MIT 许可证


Troubleshooting | 故障排除

英语:如果遇到问题,请确保:

  • Node.js已安装并可访问
  • MCP配置中的路径是正确和绝对的
  • 您的MCP客户端支持MCP协议

中文: 如果遇到问题,请确保:

  • Node.js 已安装且可访问
  • MCP 配置中的路径正确且为绝对路径
  • 你的 MCP 客户端支持 MCP 协议