Tick List MCP服务

这是一个为TickTick/Dada365开发的Model Context Protocol (MCP)服务器，使用TypeScript编写。此服务允许AI助手通过标准化接口与tick列表API进行交互。

特性

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

快速开始

使用MCP（Node版本）

DIDA正式获取令牌

OpenAPI - API 文档

下载

npm i dida365-mcp-servers

配置JSON文件

    "dida365": {
      "command": "node",
      "args": [
 			//你的下载路径；例如：C:\\nvm4w\\nodejs\\node_modules\\dida365-mcp-servers\\dist
      ],
      "env": {
        "DIDA365_TOKEN": 你的TOKEN
      }
    }

使用本地

1. 安装依赖

npm install

2. 配置环境变量

复制示例环境变量文件：

cp .env.example .env

编辑.env文件，添加你的tick列表API令牌：

DIDA365_TOKEN=Bearer 你的token在这里

3. 获取API令牌

1. 访问Tick List开放平台
2. 登录到你的tick列表账户
3. 创建一个新的应用
4. 获取访问令牌
5. 将令牌添加到文件中的.env中

4. 构建和运行

开发模式：

npm run dev

生产模式：

npm run build
npm start

可用工具

任务管理

create_task -创建新任务

• 参数：
  • title (字符串，必需)：任务标题
  • projectId (字符串，必需)：项目ID
  • content (字符串)：任务内容描述
  • dueDate (字符串)：截止日期（ISO 8601格式）
  • priority (数字)：优先级（0-5）

get_task_by_projectId_and_taskId -通过项目ID和任务ID检索任务

• 参数：
  • projectId (字符串，必需)：项目ID
  • taskId (字符串，必需)：任务ID

get_tasks_by_projectId -通过项目ID检索项目中的任务列表

• 参数： 无

update_task -更新任务

• 参数：
  • taskId (字符串，必需)：任务ID
  • title (字符串)：任务标题
  • content (字符串)：任务内容
  • dueDate (字符串)：截止日期
  • priority (数字)：优先级
  • status (数字)：任务状态（0：未完成，1：已完成）

delete_task -删除任务

• 参数：
  • taskId (字符串，必需)：任务ID
  • projectId (字符串，必需)：项目ID

complete_task -完成任务

• 参数：
  • taskId (字符串，必需)：任务ID
  • projectId (字符串，必需)：项目ID

项目管理

get_projects -获取项目列表

• 参数：无

get_project_by_projectId -根据项目ID检索项目

• 参数：
  • projectId (字符串，必需)：项目ID

create_project -创建新项目

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

update_project_by_projectID -根据projectId更新项目

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

delete_project_by_projectID -根据projectId删除项目

• 参数：
  • projectId (字符串，必需)：项目ID

可用资源

dida365://tasks

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

dida365://projects

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

项目结构

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

API接口描述

此服务使用Tick List官方API：

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

错误处理

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

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

开发说明

贡献

欢迎提交Issue和Pull Requests！