滴答清单 MCP 服务器

一个基于 Model Context Protocol (MCP) 的滴答清单（Dida365）集成服务器，让你可以在与 AI 对话时自动创建和管理滴答清单任务。

功能特性

• ✅ 创建单个或批量任务
• 📋 获取任务列表
• 📁 获取项目（清单）列表
• ✏️ 更新任务信息
• ✔️ 标记任务完成
• 🔍 搜索任务
• 🎯 支持设置优先级、截止日期、标签等

安装

1. 安装依赖

cd /Users/lonky/cursor/skill/dida-mcp-server
npm install

2. 配置认证

复制环境变量模板：

cp .env.example .env

编辑 .env 文件，填入你的滴答清单账号：

# 方式 1: 使用用户名密码（推荐新手）
DIDA_USERNAME=your_email@example.com
DIDA_PASSWORD=your_password

# 方式 2: 使用 Token（更安全，推荐）
# DIDA_ACCESS_TOKEN=your_access_token
# DIDA_CSRF_TOKEN=your_csrf_token

如何获取 Token（可选）：

1. 在浏览器登录 滴答清单
2. 打开浏览器开发者工具（F12）
3. 查看 Cookie，找到 t 和 _csrf_token 的值
4. 将它们填入 .env 文件

3. 编译项目

npm run build

配置到 AI 客户端

配置到 Claude Desktop

编辑配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "dida": {
      "command": "node",
      "args": ["/Users/lonky/cursor/skill/dida-mcp-server/dist/index.js"],
      "env": {
        "DIDA_USERNAME": "your_email@example.com",
        "DIDA_PASSWORD": "your_password"
      }
    }
  }
}

配置到 Cursor

编辑 Cursor 的 MCP 配置文件：

macOS: ~/.cursor/mcp_config.json

{
  "mcpServers": {
    "dida": {
      "command": "node",
      "args": ["/Users/lonky/cursor/skill/dida-mcp-server/dist/index.js"],
      "env": {
        "DIDA_USERNAME": "your_email@example.com",
        "DIDA_PASSWORD": "your_password"
      }
    }
  }
}

使用方法

配置完成后，重启 Claude Desktop 或 Cursor，你就可以直接在对话中管理滴答清单任务了！

示例对话

用户: "帮我在滴答清单创建一个任务：明天下午3点开会讨论项目进展"

AI: 自动调用 MCP 工具创建任务 "✅ 已为你创建任务！"

用户: "把这些待办事项加到我的滴答清单：

1. 完成项目文档
2. 回复客户邮件
3. 准备周报"

AI: 批量创建任务 "✅ 已批量创建 3 个任务！"

用户: "给我看看今天的任务"

AI: 调用获取任务列表 "📋 你今天有以下任务：..."

可用工具

MCP 服务器提供以下工具：

create_task

创建单个任务

• title (必填): 任务标题
• content: 任务描述
• priority: 优先级 (0=无, 1=低, 3=中, 5=高)
• dueDate: 截止日期 (ISO 8601 格式)
• projectId: 项目 ID
• tags: 标签数组

create_multiple_tasks

批量创建任务

• tasks: 任务数组
• projectId: 统一的项目 ID

get_tasks

获取任务列表

• projectId: 项目 ID（可选）

get_projects

获取所有项目（清单）

complete_task

标记任务完成

• taskId: 任务 ID
• projectId: 项目 ID

update_task

更新任务

• taskId: 任务 ID
• 其他字段同 create_task

search_tasks

搜索任务

• query: 搜索关键词

开发调试

监听模式（开发时使用）

npm run watch

手动运行

npm start

API 文档

本项目使用滴答清单官方 API：

• 滴答清单开发者文档
• 获取 Access Token

注意事项

1. 安全性: 不要将包含密码的 .env 文件提交到代码仓库
2. Token 过期: Access Token 有效期约 2 小时，服务器会在需要时自动重新登录
3. API 限流: 滴答清单 API 可能有频率限制，避免短时间内大量请求

故障排除

登录失败

• 检查用户名和密码是否正确
• 确认滴答清单账号状态正常
• 尝试使用 Token 方式认证

MCP 服务器无法连接

• 确认已正确编译项目 (npm run build)
• 检查配置文件路径是否正确
• 查看 Claude Desktop 或 Cursor 的日志输出

任务创建失败

• 确认已成功登录（查看控制台输出）
• 检查任务参数是否符合要求
• 查看 API 返回的错误信息

License

MIT

相关链接

• Model Context Protocol
• 滴答清单
• MCP SDK