Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Time MCPconvert 10:00 AM Beijing time to New York time"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Time MCP
一个时间处理的 MCP (Model Context Protocol) 工具,基于 Python + FastMCP 构建。
功能特性
工具 | 说明 |
| 获取当前时间 |
| 时间计算(加减年/月/日/时/分/秒) |
| 时区转换 |
| 列出可用时区 |
核心特性
🕐 默认使用北京时间(Asia/Shanghai)
🔢 时间戳自动识别(10 位秒级 / 13 位毫秒级)
📅 支持多种时间输入格式
🌍 支持全球时区转换
安装
使用 uv(推荐)
使用 pip
使用方法
启动 MCP 服务
服务默认使用 HTTP 方式运行在 8000 端口:
启动后,MCP 服务将在 http://localhost:8000 上监听。
在 Cursor 中配置
在 ~/.cursor/mcp.json 中添加:
或者使用命令行方式(无需单独启动服务):
在 Claude Desktop 中配置
在 Claude Desktop 配置文件中添加:
工具详细说明
get_current_time
获取当前时间,返回多种格式。
参数:
参数 | 类型 | 默认值 | 说明 |
| string | Asia/Shanghai | 时区 |
| string | - | 自定义输出格式 |
返回示例:
time_calculate
时间计算,对指定时间进行加减运算。
参数:
参数 | 类型 | 默认值 | 说明 |
| string/int | 当前时间 | 基准时间(时间戳或日期字符串) |
| int | 0 | 加减年数 |
| int | 0 | 加减月数 |
| int | 0 | 加减天数 |
| int | 0 | 加减小时数 |
| int | 0 | 加减分钟数 |
| int | 0 | 加减秒数 |
| string | Asia/Shanghai | 时区 |
使用示例:
timezone_convert
时区转换,将时间转换为指定时区。
参数:
参数 | 类型 | 默认值 | 说明 |
| string/int | - | 输入时间 |
| string | Asia/Shanghai | 源时区 |
| string | - | 目标时区 |
使用示例:
list_timezones
列出可用时区。
参数:
参数 | 类型 | 默认值 | 说明 |
| string | - | 按区域筛选(如 Asia, America, Europe) |
项目结构
技术栈
Python 3.11+
FastMCP >= 2.0.0 - MCP 服务框架
python-dateutil - 时间解析
pytz - 时区支持
开源协议
本项目采用 MIT License 开源协议。