IoEHub MCP Time Server

IoEHub MCP 时间服务

一个可靠的 MCP（Model Context Protocol）时间服务，可提供当前 Unix 时间戳。此服务实现了 MCP 协议，为无法获取当前时间的 AI 模型提供时间信息。

功能

• 极高可靠性：即使标准输入／输出连接关闭，也能持续运行
• 全面日志记录：同时将日志写入标准错误和文件，便于排查问题
• 自我修复：抵御终止尝试并保持可用
• 丰富的时间信息：以多种格式提供时间数据
• 符合 MCP 协议：与 Claude、Cursor 及其他 MCP 客户端完全兼容

安装和使用

有几种启动服务的方法：

方法 1：使用批处理文件（推荐用于 Windows）

start-mcp-server.bat

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

方法 2：直接使用 node 命令

node ioehub-time.js

方法 3：使用 npm

npm install
npm start

协议支持

此服务实现了 Model Context Protocol（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)"
}

日志记录

日志会同时写入标准错误和 logs 目录中的日志文件。每个服务实例都会创建一个带时间戳的新日志文件，便于排查问题。

与 AI 平台集成

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 搭配使用

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"
      ]
    }
  }
}

2. Claude 将通过 MCP 协议自动获得时间服务的访问权限。你可以通过函数调用直接获取时间信息：

I need to get the current time.

与 Cursor 搭配使用

在需要时间戳的 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"
      ]
    }
  }
}

2. Cursor 将通过 MCP 协议自动获取当前时间信息。

故障排查

如果遇到问题：

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