Dida365 MCP Servers

🚀 滴答清单 MCP 服务

这是一个专为滴答清单（TickTick/Dida365）开发的 Model Context Protocol (MCP) 服务器，采用 TypeScript 编写。该服务允许 AI 助手通过标准化接口与滴答清单 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

✨ 主要特性

• ✅ 支持任务的创建、读取、更新和删除操作。
• ✅ 可对项目和项目列表进行有效管理。
• ✅ 支持设置任务优先级和截止日期。
• ✅ 通过环境变量安全配置 API Token。
• ✅ 具备完整的 TypeScript 类型支持。
• ✅ 拥有完善的错误处理和 API 响应验证机制。

📦 安装指南

使用MCP (Node版本)

• 从 DIDA 官方获取 token，参考 OpenAPI - API Doc。
• 执行 npm i dida365-mcp-servers 进行下载。
• 配置 json 文件，设置好下载路径和 API Token。

使用本地

• 执行 npm install 安装依赖。
• 复制 .env.example 为 .env，并编辑添加 API Token。
• 按步骤从滴答清单开放平台获取 API Token 并添加到 .env 文件。
• 根据需求选择开发模式（npm run dev）或生产模式（npm run build 和 npm start）运行。

💻 使用示例

任务管理

create_task - 创建新任务

// 示例代码，假设已经有了正确的 API 调用环境
const params = {
    title: "新任务标题",
    projectId: "your_project_id",
    content: "任务内容描述",
    dueDate: "2024-01-01T00:00:00Z",
    priority: 3
};
// 调用 create_task 方法创建任务
// 这里省略具体的 API 调用代码

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

const params = {
    projectId: "your_project_id",
    taskId: "your_task_id"
};
// 调用 get_task_by_projectId_and_taskId 方法获取任务
// 这里省略具体的 API 调用代码

项目管理

get_projects - 获取项目列表

// 调用 get_projects 方法获取项目列表
// 这里省略具体的 API 调用代码

📚 详细文档

可用工具

任务管理

项目管理

可用资源

• 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！