AI导哈

日期时间服务

一个提供多种格式当前日期时间获取功能的MCP服务器，支持ISO8601、Unix时间戳和人类可读格式，适用于需要精确时间戳的应用场景。

  • by dohdalabs
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 dohdalabs/datetime-mcp

使用说明

日期时间MCP服务器

一种模型上下文协议（MCP）服务器，提供用于以各种格式检索当前日期时间的工具，重点是ISO8601格式。

特性

  • ISO8601格式：以标准ISO8601格式返回日期时间（默认）
  • 多种格式：支持ISO8601、Unix时间戳和人类可读格式
  • 时区支持：UTC（默认）或本地系统时区
  • 微秒级精度：ISO8601格式的可选微秒精度
  • 单一二进制：编译的Go二进制-不需要依赖关系或运行时

安装

从源头构建

  1. 安装 去 （1.21或更高版本）

  2. 构建二进制文件：

go build -o datetime-mcp main.go

这创建了一个单一 datetime-mcp 二进制文件，你可以在任何地方运行。

  1. （可选）安装到PATH中的某个目录：
sudo mv datetime-mcp /usr/local/bin/

用法

运行服务器

直接运行服务器：

./datetime-mcp

或者，如果安装在PATH中：

datetime-mcp

可用工具

服务器提供了一个工具：

get_current_datetime

获取指定格式和时区的当前日期时间。

参数：

  • timezone （可选）：要么 "UTC" （默认）或 "local"
  • format （可选）：以下之一：
    • "iso8601" （默认）-ISO8601格式（例如。， 2025-10-30T14:23:45.123456+00:00)
    • "unix_timestamp" -Unix时间戳（例如。， 1730301825.123456)
    • "human_readable" -人性化格式（例如。， October 30, 2025 at 2:23:45 PM UTC)
  • include_microseconds （可选）：是否以ISO8601格式包含微秒（默认值： true)

示例：

  1. 获取ISO8601 UTC（默认）中的当前时间：
{}

或

{
  "timezone": "UTC",
  "format": "iso8601",
  "include_microseconds": true
}
  1. 获取ISO8601中的当前本地时间：
{
  "timezone": "local",
  "format": "iso8601"
}
  1. 获取Unix时间戳：
{
  "format": "unix_timestamp"
}
  1. 获取人类可读的格式：
{
  "timezone": "UTC",
  "format": "human_readable"
}
  1. 获取不含微秒的ISO8601：
{
  "format": "iso8601",
  "include_microseconds": false
}

配置

与Claude Desktop一起使用

将此服务器添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "datetime": {
      "command": "/path/to/datetime-mcp"
    }
  }
}

替换 /path/to/datetime-mcp 使用二进制文件的实际路径。

与光标一起使用

将此服务器添加到您的Cursor MCP配置文件中：

macOS/Linux: ~/.cursor/mcp.json 视窗: %APPDATA%\Cursor\mcp.json

{
  "mcpServers": {
    "datetime": {
      "command": "/path/to/datetime-mcp"
    }
  }
}

替换 /path/to/datetime-mcp 使用二进制文件的实际路径。

设计决策

此MCP服务器遵循最佳实践：

  1. 明确命名：服务器名称 datetime-mcp 遵循惯例
  2. 输入验证：验证输入参数并提供合理的默认值
  3. 综合文档：详细说明和示例
  4. 单一二进制：无依赖关系-只有一个可执行文件
  5. 合理违约：默认为ISO8601 UTC格式作为最标准的选项

建筑

服务器内置于Go中，通过stdio使用MCP JSON-RPC协议，提供：

  • 简单、无依赖性的部署
  • 快速启动和执行
  • 跨平台二进制支持
  • 不需要运行时环境

跨平台构建

为不同平台构建：

# macOS (Intel)
GOOS=darwin GOARCH=amd64 go build -o datetime-mcp-darwin-amd64 main.go

# macOS (Apple Silicon)
GOOS=darwin GOARCH=arm64 go build -o datetime-mcp-darwin-arm64 main.go

# Linux (64-bit)
GOOS=linux GOARCH=amd64 go build -o datetime-mcp-linux-amd64 main.go

# Windows
GOOS=windows GOARCH=amd64 go build -o datetime-mcp-windows-amd64.exe main.go

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

此服务器实现 模型上下文协议（MCP） 规范。

相关 MCP