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！