# Dida365 MCP Server

> **让 Claude AI 直接管理你的滴答清单待办事项**

这是一个 MCP (Model Context Protocol) 服务器，让 AI 助手能够直接操作你的滴答清单账号。

---

## 🎯 能做什么

### 基础功能
- 查看所有项目/清单
- 创建、编辑、完成任务
- 设置任务优先级和截止日期

### 高级功能
- 子任务管理
- 任务提醒
- 重复任务
- 状态过滤（已完成/未完成）

---

## 🚀 快速开始（3步）

### 1. 安装依赖
```bash
cd ~/dida365-mcp-server
uv sync
```

### 2. 配置认证
```bash
uv run scripts/authenticate_auto.py
```
浏览器会自动打开，登录滴答清单并授权即可。

### 3. 配置 Claude Desktop

**方法 1：自动配置（推荐）**
```bash
uv run scripts/setup_mcp.py
```

**方法 2：手动配置**

编辑 `~/.claude.json`（macOS/Linux）或 `%APPDATA%\claude\claude.json`（Windows）：

```json
{
  "mcpServers": {
    "dida365": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/Users/YOUR_USERNAME/dida365-mcp-server",
        "run",
        "python",
        "-m",
        "src.server"
      ],
      "env": {
        "DIDA365_CLIENT_ID": "你的Client_ID",
        "DIDA365_CLIENT_SECRET": "你的Client_Secret",
        "DIDA365_REDIRECT_URI": "http://127.0.0.1:8080/callback",
        "DIDA365_BASE_URL": "https://api.dida365.com/open/v1",
        "TOKEN_FILE": "/Users/YOUR_USERNAME/dida365-mcp-server/.token-oauth"
      }
    }
  }
}
```

重启 Claude Code 即可。

---

## 💡 使用示例

在 Claude Desktop 中，你可以直接用自然语言操作：

```
你：查看我的所有待办清单

AI：[显示所有清单]

你：在"工作"中创建任务：明天下午3点开会

AI：✓ 任务已创建

你：把这个任务的优先级设为高

AI：✓ 优先级已更新
```

就这么简单！AI 会自动处理所有技术细节。

---

## 📚 更多信息

- **完整功能说明**：查看 `AI_GUIDE.md`
- **测试功能**：运行 `uv run scripts/comprehensive_test.py`

---

## 🔒 安全性

- ✅ 使用官方 OAuth 2.0 认证
- ✅ Token 本地存储，不上传
- ✅ Token 有效期约 6 个月

---

## 📄 许可证

MIT License