Date-MCP 服务

一个基于Model Context Protocol (MCP)的日期时间处理服务，专注于处理东八区（中国）时间与时间戳的转换。

功能特点

• 获取当前日期：返回东八区（中国）当前日期
• 时间戳转换：将13位毫秒级时间戳转换为东八区日期时间
• 日期转时间戳：将东八区日期时间字符串转换为13位毫秒级时间戳
• 问候资源：提供简单的问候功能

系统要求

• Python >= 3.13
• 依赖包：mcp[cli] >= 1.9.1, pytz

安装说明

1. 克隆仓库

git clone <仓库地址>
cd date_mcp

2. 安装依赖

pip install -e .

或使用 uv 安装（推荐）：

uv pip install -e .

使用方法

启动服务

python main.py

或使用 MCP CLI 工具：

mcp dev main.py

可用工具

1. 获取当前日期

# 工具名: get_date
# 返回格式: YYYY-MM-DD
response = await client.call_tool("get_date")
# 示例输出: "2024-05-28"

2. 时间戳转日期时间

# 工具名: timestamp_to_china_date
# 参数: millis_timestamp (int) - 13位毫秒级时间戳
response = await client.call_tool("timestamp_to_china_date", {"millis_timestamp": 1746773348432})
# 示例输出: "2025-05-09 12:35:48.432"

3. 日期时间转时间戳

# 工具名: china_date_to_timestamp
# 参数: date_str (str) - 东八区时间字符串
response = await client.call_tool("china_date_to_timestamp", {"date_str": "2025-05-09 12:35:48.432"})
# 示例输出: 1746773348432

可用资源

问候资源

# 资源URI: greeting://{name}
# 参数: name (str) - 要问候的名称
response = await client.get_resource(f"greeting://World")
# 示例输出: "Hello, World!"

客户端示例

from mcp.client import Client
from mcp.transport import StdioClientTransport

async def main():
    # 创建客户端
    transport = StdioClientTransport("python main.py")
    client = Client(transport)
    
    # 连接到服务器
    await client.connect()
    
    # 调用工具示例
    current_date = await client.call_tool("get_date")
    print(f"当前日期: {current_date}")
    
    # 时间戳转日期
    timestamp = 1746773348432
    date_time = await client.call_tool("timestamp_to_china_date", {"millis_timestamp": timestamp})
    print(f"时间戳 {timestamp} 对应的日期时间: {date_time}")
    
    # 日期转时间戳
    date_str = "2025-05-09 12:35:48.432"
    new_timestamp = await client.call_tool("china_date_to_timestamp", {"date_str": date_str})
    print(f"日期时间 {date_str} 对应的时间戳: {new_timestamp}")
    
    # 获取问候资源
    greeting = await client.get_resource("greeting://World")
    print(greeting)
    
    # 断开连接
    await client.disconnect()

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

许可证

贡献指南

欢迎提交问题和拉取请求，共同改进这个项目。