滴答清单 MCP 服务

这是一个为滴答清单（TickTick/Dida365）开发的 Model Context Protocol (MCP) 服务器，使用 TypeScript 编写。该服务允许 AI 助手通过标准化接口与滴答清单 API 进行交互。

功能特性

• ✅ 创建、读取、更新、删除任务
• ✅ 管理项目和项目列表
• ✅ 支持任务优先级和截止日期
• ✅ 通过环境变量安全配置 API Token
• ✅ 完整的 TypeScript 类型支持
• ✅ 错误处理和API响应验证

快速开始

使用MCP (Node版本)

DIDA官方获取token

OpenAPI - API Doc

下载

npm i dida365-mcp-servers

配置json文件

"dida365": {
      "command": "node",
      "args": [
 			//your download path ; example:C:\\nvm4w\\nodejs\\node_modules\\dida365-mcp-servers\\dist
      ],
      "env": {
        "DIDA365_TOKEN": your TOKEN
      }
    }

使用本地

1. 安装依赖

npm install

2. 配置环境变量

复制示例环境变量文件：

cp .env.example .env

编辑 `.env` 文件，添加你的滴答清单 API Token：

DIDA365_TOKEN=Bearer your_token_here

3. 获取 API Token

1. 访问 滴答清单开放平台

2. 登录你的滴答清单账号

3. 创建新应用

4. 获取访问令牌（Access Token）

5. 将令牌添加到 `.env` 文件中

4. 构建和运行

开发模式：

npm run dev

生产模式：

npm run build
npm start

可用工具

任务管理

`create_task` - 创建新任务

• 参数:
  • `title` (string, 必需): 任务标题
  • `projectId` (string, 必需): 项目ID
  • `content` (string): 任务内容描述
  • `dueDate` (string): 截止日期 (ISO 8601格式)
  • `priority` (number): 优先级 (0-5)

`get_task_by_projectId_and_taskId` - 通过项目ID和任务ID获取任务

• 参数:
  • `projectId` (string, 必需): 项目ID
  • `taskId` (string, 必需): 任务ID

`get_tasks_by_projectId` - 通过项目ID获取项目中的任务列表

• 参数:
  • `projectId` (string, 必需): 项目ID

`update_task` - 更新任务

• 参数:
  • `taskId` (string, 必需): 任务ID
  • `title` (string): 任务标题
  • `content` (string): 任务内容
  • `dueDate` (string): 截止日期
  • `priority` (number): 优先级
  • `status` (number): 任务状态 (0: 未完成, 1: 已完成)

`delete_task` - 删除任务

• 参数:
  • `taskId` (string, 必需): 任务ID
  • `projectId` (string, 必需): 项目ID

`complete_task` - 完成任务

• 参数:
  • `taskId` (string, 必需): 任务ID
  • `projectId` (string, 必需): 项目ID

项目管理

`get_projects` - 获取项目列表

• 参数: 无

`get_project_by_projectId` - 根据项目ID获取项目

• 参数:
  • `projectId` (string, 必需): 项目ID

`create_project` - 创建新项目

• 参数:
  • `name` (string, 必需): 项目名称
  • `color` (string): 项目颜色, 例如 "#F18181"
  • `sortOrder` (integer): 排序值, 默认为0
  • `viewMode` (string): 视图模式 ("list", "kanban", "timeline")
  • `kind` (string): 项目类型 ("TASK", "NOTE")

`update_project_by_projectID` - 根据projectId更新项目

• 参数:
  • `projectId` (string, 必需): 项目ID
  • `name` (string): 项目名称
  • `color` (string): 项目颜色
  • `sortOrder` (integer): 排序值, 默认为0
  • `viewMode` (string): 视图模式 ("list", "kanban", "timeline")
  • `kind` (string): 项目类型 ("TASK", "NOTE")

`update_project_by_projectID` - 根据projectId删除项目

• 参数:
  • `projectId` (string, 必需): 项目ID

可用资源

`dida365://tasks`

获取所有任务的JSON格式概览

`dida365://projects`

获取所有项目的JSON格式概览

项目结构

├── src/
│   └── index.ts          # 主服务器文件
├── dist/                 # 编译输出目录
├── .env.example          # 环境变量示例
├── package.json          # 项目配置
├── tsconfig.json        # TypeScript 配置
└── README.md            # 项目文档

API 接口说明

本服务使用滴答清单官方 API：

• 基础URL: `https://api.dida365.com/open/v1`
• 认证方式: Bearer Token
• 请求格式: JSON
• 官方文档: https://developer.dida365.com/api#/openap

错误处理

服务包含完整的错误处理机制：

• API 调用失败时返回详细错误信息
• 网络错误和超时处理
• 参数验证和类型检查
• Token 验证

开发说明

贡献

欢迎提交 Issue 和 Pull Request！