# Date-MCP 服务

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

## 功能特点

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

## 系统要求

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

## 安装说明

1. 克隆仓库

```bash
git clone <仓库地址>
cd date_mcp
```

2. 安装依赖

```bash
pip install -e .
```

或使用 uv 安装（推荐）：

```bash
uv pip install -e .
```

## 使用方法

### 启动服务

```bash
python main.py
```

或使用 MCP CLI 工具：

```bash
mcp dev main.py
```

### 可用工具

1. **获取当前日期**

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

2. **时间戳转日期时间**

```python
# 工具名: 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. **日期时间转时间戳**

```python
# 工具名: 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
```

### 可用资源

**问候资源**

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

## 客户端示例

```python
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())
```

## 许可证



## 贡献指南

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