Skip to main content
Glama
xbsheng

Time MCP

by xbsheng

Time MCP

一个时间处理的 MCP (Model Context Protocol) 工具,基于 Python + FastMCP 构建。

功能特性

工具

说明

get_current_time

获取当前时间

time_calculate

时间计算(加减年/月/日/时/分/秒)

timezone_convert

时区转换

list_timezones

列出可用时区

核心特性

  • 🕐 默认使用北京时间(Asia/Shanghai)

  • 🔢 时间戳自动识别(10 位秒级 / 13 位毫秒级)

  • 📅 支持多种时间输入格式

  • 🌍 支持全球时区转换

安装

使用 uv(推荐)

git clone https://github.com/xbsheng/time-mcp.git cd time-mcp uv sync

使用 pip

pip install fastmcp python-dateutil pytz

使用方法

启动 MCP 服务

服务默认使用 HTTP 方式运行在 8000 端口:

uv run python src/server.py

启动后,MCP 服务将在 http://localhost:8000 上监听。

在 Cursor 中配置

~/.cursor/mcp.json 中添加:

{ "mcpServers": { "time-mcp": { "url": "http://localhost:8000/mcp" } } }

或者使用命令行方式(无需单独启动服务):

{ "mcpServers": { "time-mcp": { "command": "uv", "args": ["--directory", "/path/to/time-mcp", "run", "python", "src/server.py"] } } }

在 Claude Desktop 中配置

在 Claude Desktop 配置文件中添加:

{ "mcpServers": { "time-mcp": { "command": "uv", "args": ["--directory", "/path/to/time-mcp", "run", "python", "src/server.py"] } } }

工具详细说明

get_current_time

获取当前时间,返回多种格式。

参数:

参数

类型

默认值

说明

timezone

string

Asia/Shanghai

时区

format

string

-

自定义输出格式

返回示例:

{ "datetime": "2026-01-12 22:00:00", "date": "2026-01-12", "time": "22:00:00", "timestamp": 1768226400, "timestamp_ms": 1768226400000, "timezone": "Asia/Shanghai", "iso": "2026-01-12T22:00:00+08:00", "weekday": "Monday", "weekday_cn": "周一" }

time_calculate

时间计算,对指定时间进行加减运算。

参数:

参数

类型

默认值

说明

base_time

string/int

当前时间

基准时间(时间戳或日期字符串)

years

int

0

加减年数

months

int

0

加减月数

days

int

0

加减天数

hours

int

0

加减小时数

minutes

int

0

加减分钟数

seconds

int

0

加减秒数

timezone

string

Asia/Shanghai

时区

使用示例:

# 当前时间加7天 time_calculate(days=7) # 指定时间减1个月 time_calculate(base_time="2026-01-01", months=-1) # 时间戳加8小时 time_calculate(base_time=1704067200, hours=8)

timezone_convert

时区转换,将时间转换为指定时区。

参数:

参数

类型

默认值

说明

time

string/int

-

输入时间

from_tz

string

Asia/Shanghai

源时区

to_tz

string

-

目标时区

使用示例:

# 北京时间转纽约时间 timezone_convert(time="2026-01-12 12:00:00", to_tz="America/New_York")

list_timezones

列出可用时区。

参数:

参数

类型

默认值

说明

region

string

-

按区域筛选(如 Asia, America, Europe)

项目结构

time-mcp/ ├── src/ │ ├── __init__.py │ └── server.py # MCP 服务主文件 ├── pyproject.toml # 项目配置 ├── uv.lock # 依赖锁定 ├── LICENSE └── README.md

技术栈

开源协议

本项目采用 MIT License 开源协议。

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/xbsheng/time-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server