theo01/mcp-time

Time MCP Server

概述

Time MCP Server是一个https://github.com/modelcontextprotocol%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E4%B8%BAAI%E5%8A%A9%E6%89%8B%E5%92%8C%E5%85%B6%E4%BB%96MCP%E5%AE%A2%E6%88%B7%E7%AB%AF%E6%8F%90%E4%BE%9B%E6%A0%87%E5%87%86%E5%8C%96%E5%B7%A5%E5%85%B7%EF%BC%8C%E7%94%A8%E4%BA%8E%E6%89%A7%E8%A1%8C%E6%97%B6%E9%97%B4%E5%92%8C%E6%97%A5%E6%9C%9F%E7%9B%B8%E5%85%B3%E6%93%8D%E4%BD%9C%E3%80%82%E8%AF%A5%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%85%85%E5%BD%93AI%E5%B7%A5%E5%85%B7%E4%B8%8E%E5%BC%BA%E5%A4%A7%E6%97%B6%E9%97%B4%E5%A4%84%E7%90%86%E5%90%8E%E7%AB%AF%E4%B9%8B%E9%97%B4%E7%9A%84%E6%A1%A5%E6%A2%81%EF%BC%8C%E5%85%81%E8%AE%B8%E9%80%9A%E8%BF%87%E8%87%AA%E7%84%B6%E8%AF%AD%E8%A8%80%E4%BA%A4%E4%BA%92%E8%BF%9B%E8%A1%8C%E5%A4%8D%E6%9D%82%E7%9A%84%E6%97%B6%E9%97%B4%E6%93%8D%E4%BD%9C%E3%80%82

核心功能和特性

• ⏰ 时间操作 - 获取当前时间、进行时区转换以及添加或减去持续时间
• 🗣️ 自然语言解析 - 理解相对时间表达式，如"昨天"或"下个月"
• ⚖️ 时间比较 - 轻松比较两个不同的时间
• 🎨 灵活格式化 - 支持多种预定义和自定义时间格式
• ✅ MCP合规性 - 完全符合模型上下文协议标准
• 🔄 多种传输方式 - 支持stdio用于本地集成和HTTP stream用于网络访问

安装方法

此MCP服务器可与支持模型上下文协议的各种AI助手客户端集成，包括https://cursor.com/%E3%80%81https://claude.ai/download%E3%80%81Claude Code以及https://modelcontextprotocol.io/clients%E3%80%82

🚀 一键安装（Cursor）

点击下方按钮，在https://cursor.com%E7%8E%AF%E5%A2%83%E4%B8%AD%E4%BD%BF%E7%94%A8Docker%E8%87%AA%E5%8A%A8%E9%85%8D%E7%BD%AEMCP%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%9A

使用npx（JavaScript/Node.js）

此方法使用https://docs.npmjs.com/cli/v8/commands/npx%E8%BF%90%E8%A1%8CMCP%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E9%9C%80%E8%A6%81%E5%AE%89%E8%A3%85Node.js%E3%80%82%E5%B0%86%E4%BB%A5%E4%B8%8BJSON%E9%85%8D%E7%BD%AE%E5%A4%8D%E5%88%B6%E5%88%B0%E6%82%A8%E7%9A%84MCP%E5%AE%A2%E6%88%B7%E7%AB%AF%E8%AE%BE%E7%BD%AE%E4%B8%AD%EF%BC%9A

json
{
  "mcpServers": {
    "mcp-time": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@theo.foobar/mcp-time"
      ]
    }
  }
}

使用Docker

在隔离容器中运行MCP服务器。需要安装https://www.docker.com/get-started/%E3%80%82%E5%B0%86%E4%BB%A5%E4%B8%8BJSON%E9%85%8D%E7%BD%AE%E5%A4%8D%E5%88%B6%E5%88%B0%E6%82%A8%E7%9A%84MCP%E5%AE%A2%E6%88%B7%E7%AB%AF%E8%AE%BE%E7%BD%AE%E4%B8%AD%EF%BC%9A

json
{
  "mcpServers": {
    "mcp-time": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "theo01/mcp-time:latest"
      ]
    }
  }
}

使用二进制文件

直接在系统上安装mcp-time二进制文件。选择以下安装方法之一，确保二进制文件位于PATH环境变量中的目录。然后将此JSON配置添加到MCP客户端设置中：

json
{
  "mcpServers": {
    "mcp-time": {
      "type": "stdio",
      "command": "mcp-time"
    }
  }
}

选项1：从发布页面下载

从https://github.com/TheoBrigitte/mcp-time/releases%E4%B8%8B%E8%BD%BD%E6%9C%80%E6%96%B0%E7%9A%84%E9%A2%84%E6%9E%84%E5%BB%BA%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%EF%BC%9A

bash
# 将OS-ARCH替换为您的平台（例如linux-amd64、darwin-arm64、windows-amd64）
curl -Lo mcp-time https://github.com/TheoBrigitte/mcp-time/releases/latest/download/mcp-time.OS-ARCH
install -D -m 755 ./mcp-time ~/.local/bin/mcp-time

选项2：使用Go安装

对于Go开发者，可使用go install直接安装：

bash
go install github.com/TheoBrigitte/mcp-time/cmd/mcp-time@latest

二进制文件将安装在$GOPATH/bin目录中。

选项3：从源代码构建

使用make克隆并构建项目：

bash
git clone https://github.com/TheoBrigitte/mcp-time.git
cd mcp-time
make install

二进制文件将安装在~/.local/bin/mcp-time。

使用方法

基本使用

使用stdio传输启动（默认，适用于MCP客户端）：

bash
mcp-time

使用HTTP stream传输启动（用于网络访问）：

bash
mcp-time --transport stream --address "http://localhost:8080/mcp"

命令行选项

服务器支持以下标志用于高级配置：

$ mcp-time --help
一个MCP（模型上下文协议）服务器，提供处理时间和日期的工具。

用法:
  mcp-time [标志]

标志:
      --address string     Stream HTTP服务器的监听地址（仅用于--transport stream）(默认 "http://localhost:8080/mcp")
  -h, --help               显示帮助信息
      --log-file string    日志文件路径（未指定则禁用日志）
  -t, --transport string   传输层：stdio、stream。(默认 "stdio")
      --version            打印版本信息并退出

可用工具

current_time

获取任何时区和格式的当前时间。

参数:

• format（可选）- 输出格式（预定义如RFC3339、Kitchen或自定义Go布局）
• timezone（可选）- IANA格式的目标时区（例如America/New_York）。默认为UTC

示例: "东京现在几点？"

relative_time

基于相对自然语言表达式获取时间。

参数:

• text（必填）- 自然语言表达式（例如yesterday、5 minutes ago、next month）
• time（可选）- 表达式的参考时间。默认为当前时间
• timezone（可选）- 输出的目标时区
• format（可选）- 时间的输出格式

示例: "三周前是几号？"

convert_timezone

在时区之间转换给定时间。

参数:

• time（必填）- 输入时间字符串（支持多种格式）
• input_timezone（可选）- 输入时间的时区
• output_timezone（可选）- 输出的目标时区
• format（可选）- 时间的输出格式

示例: "将美国东部时间下午2:30转换为东京时间"

add_time

从给定时间添加或减去持续时间。

参数:

• time（必填）- 输入时间字符串
• duration（必填）- 要添加/减去的持续时间（例如2h30m、-1h、24h）
• timezone（可选）- 输出的目标时区
• format（可选）- 时间的输出格式

示例: "45分钟后是什么时间？"

compare_time

比较两个时间并确定它们的关系。支持时区感知比较。

参数:

• time_a（必填）- 要比较的第一个时间
• time_a_timezone（可选）- time_a的IANA格式时区（例如America/New_York）
• time_b（必填）- 要比较的第二个时间
• time_b_timezone（可选）- time_b的IANA格式时区（例如Europe/London）

返回:

• -1 如果time_a在time_b之前
• 0 如果time_a等于time_b
• 1 如果time_a在time_b之后

示例: "美国东部时间下午3点在格林威治标准时间晚上8点之前吗？"

贡献

欢迎贡献！请随时提交Pull Request。对于重大更改，请先打开issue讨论您想要更改的内容。

许可证

本项目采用MIT许可证 - 详见LICENSE文件。

credits

使用以下优秀库构建：

• https://github.com/araddon/dateparse - 无需知道格式即可解析日期
• https://github.com/tj/go-naturaldate - 自然语言日期解析
• https://github.com/mark3labs/mcp-go - Go语言的模型上下文协议SDK