时间服务器

一个基于MCP协议的可靠时间服务器,为AI模型提供多种格式的时间信息。

  • by ioehub
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ioehub/ioehub-mcp-time-server

使用说明

IoEHub MCP时间服务器

一个强大的MCP(模型上下文协议)时间服务器,提供当前的Unix时间戳。此服务器实现MCP协议,为无法访问当前时间的AI模型提供时间信息。

特性

  • 极高的可靠性:即使stdin/stdout连接关闭,也能保持运行
  • 综合录井:记录到stderr和文件以进行故障排除
  • 自愈:抵制终止尝试并保持可用性
  • 丰富的时间信息:以多种格式提供时间数据
  • 符合MCP协议:与Claude、Cursor和其他MCP客户端完全兼容

安装和使用

有几种方法可以启动服务器:

方法1:使用批处理文件(推荐用于Windows)

start-mcp-server.bat

这将在后台模式下启动服务器,使其能够独立运行。

方法2:直接节点命令

node ioehub-time.js

方法3:使用npm

npm install
npm start

协议支持

此服务器实现了模型上下文协议(MCP),并支持以下方法:

  • initialize:用功能初始化服务器
  • getTime:以各种格式获取当前时间
  • shutdown:优雅地关闭服务器(服务器实际上仍在运行)

时间响应格式

服务器以以下格式提供时间信息:

{
  "unix_time": 1713258180,
  "unix_ms": 1713258180123,
  "human_readable": "2024-04-16T09:36:20.000Z",
  "formatted": "4/16/2024, 5:36:20 PM",
  "utc": "Tue, 16 Apr 2024 09:36:20 GMT",
  "date_only": "Tue Apr 16 2024",
  "time_only": "09:36:20 GMT+0000 (Coordinated Universal Time)"
}

日志记录

日志同时写入stderr和 logs 目录。每个服务器实例都会创建一个带有时间戳的新日志文件,以便轻松排除问题。

与人工智能平台集成

MCP配置

使用以下JSON格式将时间服务器添加到MCP配置中:

{
  "mcpServers": {
    "IoEHubMcpTimeServer": {
      "command": "cmd",
      "args": [
        "/c",
        "C:\\path\\to\\your\\ioehub-mcp-time-server\\start-mcp-server.bat"
      ]
    }
  }
}

对于Unix/Linux/macOS环境:

{
  "mcpServers": {
    "IoEHubMcpTimeServer": {
      "command": "node",
      "args": [
        "/path/to/your/ioehub-mcp-time-server/ioehub-time.js"
      ]
    }
  }
}

与克劳德一起使用

Claude AI无法直接访问当前时间。要将IoEHub MCP时间服务器与Claude集成,请执行以下操作:

  1. 在MCP配置中设置IoEHub MCP时间服务器:
{
  "mcpServers": {
    "IoEHubMcpTimeServer": {
      "command": "cmd",
      "args": [
        "/c",
        "C:\\path\\to\\your\\ioehub-mcp-time-server\\start-mcp-server.bat"
      ]
    }
  }
}
  1. Claude将通过MCP协议自动访问时间服务器。您可以通过函数调用直接访问时间信息:
I need to get the current time.

与光标一起使用

当使用需要时间戳的AI辅助编码时,Cursor IDE可以从IoEHub MCP时间服务器中受益:

  1. 在项目设置中配置IoEHub MCP时间服务器:
{
  "mcpServers": {
    "IoEHubMcpTimeServer": {
      "command": "cmd",
      "args": [
        "/c",
        "C:\\path\\to\\your\\ioehub-mcp-time-server\\start-mcp-server.bat"
      ]
    }
  }
}
  1. Cursor将通过MCP协议自动访问当前时间信息。

故障排除

如果您遇到问题:

  1. 检查中的日志文件 logs 目录
  2. 确保没有其他可能发生冲突的Node.js进程正在运行
  3. 确保MCP配置指向正确的文件路径