TimeConverter

NINE24/TimeConverter

0 Stars 18 次浏览更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "TimeConverter": {
      "args": [
        "run",
        "main.py"
      ],
      "command": "uv"
    }
  }
}

Streamable HTTP 传输配置

{
  "mcpServers": {
    "TimeConverter": {
      "env": {
        "MCP_PORT": "8000",
        "PYTHONUNBUFFERED": "1"
      },
      "url": "http://localhost:8000"
    }
  }
}

服务介绍

TimeConverter MCP 服务

TimeConverter 是一个智能时间转换 MCP (Model Context Protocol) 服务，提供精准的自然语言时间表达转换为具体日期/范围的功能。

功能特性

基础时间点工具

get_today() - 获取今天的日期
get_tomorrow() - 获取明天的日期
get_yesterday() - 获取昨天的日期
get_day_after_tomorrow() - 获取后天的日期
get_day_before_yesterday() - 获取前天的日期
get_first_day_of_current_month() - 获取本月第一天
get_last_day_of_current_month() - 获取本月最后一天

周级表达工具

get_last_week() - 获取上周日期范围（周一到周日）
get_last_weekend() - 获取上周末日期范围（周六到周日）
get_last_two_weeks() - 获取上上周日期范围
get_next_week() - 获取下周日期范围
get_current_weekend() - 获取本周末日期范围

月级表达工具

get_last_month() - 获取上个月日期范围
get_current_month() - 获取本月日期范围
get_next_month() - 获取下个月日期范围
get_last_two_months() - 获取上上个月日期范围

季度级表达工具

get_current_quarter() - 获取本季度日期范围
get_last_quarter() - 获取上季度日期范围
get_next_quarter() - 获取下季度日期范围
get_quarter_start() - 获取本季度开始日期
get_quarter_end() - 获取本季度结束日期

年级表达工具

get_last_year() - 获取去年日期范围
get_current_year() - 获取今年日期范围
get_next_year() - 获取明年日期范围
get_current_year_start() - 获取今年开始日期
get_current_year_end() - 获取今年结束日期

特殊表达工具

get_current_quarter_start() - 获取本季度开始日期
get_current_quarter_end() - 获取本季度结束日期
get_month_first_week() - 获取本月第一周日期范围

农历转换功能

get_lunar_date() - 公历转农历
get_solar_date() - 农历转公历

节假日识别

get_holidays() - 获取指定时间段内的法定节假日

多时区转换

convert_timezone() - 不同时区间的时间转换

时间格式化与计算

format_date() - 日期格式化
calculate_date_difference() - 计算两个日期间的时间差

安装要求

Python >= 3.12
mcp[cli] >= 1.25.0
chinese_calendar (用于农历转换和节假日识别)
zoneinfo (用于时区转换)

安装指南

克隆或下载项目文件

使用 uv 安装依赖包：

uv add mcp[cli]
uv add chinese-calendar  # 用于农历转换

运行服务：
```
uv run main.py
```

使用方法

TimeConverter 服务通过 MCP 协议与 AI 模型交互，提供以下功能：

基础时间查询

查询今天的日期
查询明天、昨天、前天、后天的日期
查询本月第一天、最后一天

周/月/季度/年范围查询

查询上周、下周、上两周的日期范围
查询上月、本月、下月的日期范围
查询上季度、本季度、下季度的日期范围
查询去年、今年、明年的日期范围

特殊转换功能

公历与农历相互转换
查询指定时间段内的节假日
多时区时间转换
自定义日期格式化
计算两个日期间的时间差

配置说明

项目使用 mcp.server.fastmcp 框架，主要配置在 main.py 文件中：

服务名称：TimeConverter
服务描述：智能时间转换MCP - 精准解析自然语言时间表达为具体日期/范围
所有功能函数都使用 @mcp.tool() 装饰器标记为可用工具

开发与扩展

如需扩展功能，可以在 main.py 中添加新的函数，并使用 @mcp.tool() 装饰器标记为工具函数。

故障排除

如果遇到农历转换或节假日识别错误，请确认已正确安装 chinese_calendar 包
时区转换功能需要正确格式的时区标识符，如 "Asia/Shanghai", "America/New_York"
日期格式错误通常是因为输入格式不符合 "YYYY-MM-DD" 或 "YYYY-MM-DD HH:MM:SS" 格式

查看源码项目主页