AI导哈

时间服务器

一个提供时间和日期功能的模型上下文协议（MCP）服务器，支持获取当前时间、日期以及格式化时间戳。

  • by PierreGode
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 PierreGode/timeMCP

使用说明

MCP时间服务器

提供时间和日期功能的模型上下文协议（MCP）服务器。此服务器公开了用于获取当前时间、日期和格式化各种格式和时区的时间戳的工具。

特性

  • get_current时间：以ISO、本地、UTC或Unix时间戳格式获取当前时间
  • get_current _日期：获取各种格式的当前日期（ISO、本地、短、长、自定义）
  • get_datetime_info：获取全面的日期/时间信息，包括时区详细信息
  • 格式时间戳：将任何Unix时间戳格式化为可读格式

安装

  1. 克隆MCP服务器：
git clone https://github.com/PierreGode/timeMCP.git
cd timeMCP

  1. 将服务器代码另存为 timeserver.js 包配置如下 package.json

  2. 安装依赖项：

npm install
  1. 如果在Linux中使服务器可执行：
chmod +x timeserver.js

用法

运行服务器

服务器在stdio传输（标准输入/输出）上运行：

node timeserver.js

要运行服务器，您需要将其添加到MCP配置中。例如，如果您使用的是Claude Desktop，可以通过修改 claude_desktop_config.json 由于某种原因，在您重新安装Claude桌面应用程序之前，Claude可能无法识别服务器，因此您可能需要在添加服务器后执行此操作。

Claude桌面配置示例

edit claude_desktop_config.json
```bash
{
  "mcpServers": {
    "time-server": {
      "command": "node",
      "args": ["C:\\Users\\youruser\\Documents\\timeMCP\\timeserver.js"],
      "env": {}
    }
  }
}

可用工具

1.get_current_time

以各种格式获取当前时间。

参数：

  • format （可选）：“iso”、“local”、“utc”或“unix”（默认为“iso”）
  • timezone （可选）：时区字符串，如“America/New_York”（默认值：“local”）

例子：

{
  "format": "local",
  "timezone": "Europe/London"
}

2.get_current_date

获取各种格式的当前日期。

参数：

  • format （可选）：“iso”、“local”、“short”、“long”或“custom”（默认为“iso”）
  • customFormat （可选）：Intl.DateTimeFormat选项的JSON字符串（当格式为“自定义”时）
  • timezone （可选）：时区字符串（默认值：“local”）

例子：

{
  "format": "long",
  "timezone": "Asia/Tokyo"
}

3.获取时间信息

获取全面的日期和时间信息。

参数：

  • timezone （可选）：时区字符串（默认值：“local”）

例子：

{
  "timezone": "America/Los_Angeles"
}

4.格式时间戳

格式化Unix时间戳。

参数：

  • timestamp （必填）：Unix时间戳（毫秒）
  • format （可选）：“iso”、“local”、“utc”或“custom”（默认为“iso”）
  • timezone （可选）：时区字符串（默认值：“local”）

例子：

{
  "timestamp": 1703097600000,
  "format": "local",
  "timezone": "UTC"
}

与MCP客户端集成

要将此服务器与MCP客户端（如Claude Desktop）一起使用，请将其添加到MCP配置中：

Claude桌面配置

添加到您的 claude_desktop_config.json:

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

其他MCP客户端

对于其他MCP客户端，请参阅其关于如何配置MCP服务器的文档。服务器使用stdio传输并遵循标准MCP协议。

示例响应

当前时间（ISO格式）：

Current time (iso): 2024-12-20T14:30:45.123Z

当前日期（长格式）：

Current date (long): Friday, December 20, 2024

日期时间信息：

{
  "timestamp": 1703097845123,
  "iso": "2024-12-20T14:30:45.123Z",
  "local": "12/20/2024, 2:30:45 PM",
  "utc": "Fri, 20 Dec 2024 14:30:45 GMT",
  "unix": 1703097845,
  "year": 2024,
  "month": 12,
  "day": 20,
  "hour": 14,
  "minute": 30,
  "second": 45,
  "dayOfWeek": "Friday",
  "timezone": "America/New_York"
}

发展

要在开发模式下运行并进行调试，请执行以下操作：

npm run dev

错误处理

该服务器包括全面的错误处理功能，用于：

  • 时区无效
  • 时间戳无效
  • 自定义格式字符串格式错误
  • 缺少必要参数

许可证

MIT许可证

相关 MCP