Dida365 (TickTick)

🚀 Dida365（TickTick）MCP 服務端

這是一個基於 Model Context Protocol (MCP) 的服務器，提供與 Dida365（TickTick）API 交互的工具。在用戶授權後，它能讓 AI 助手對任務和項目進行管理，為任務管理帶來更智能、便捷的體驗。

✨ 主要特性

• 用戶可通過 Dida365 完成身份驗證。
• 能夠獲取所有項目（列表）。
• 可從集合箱中獲取任務。
• 支持使用多種參數創建新任務。
• 能更新集合箱中的現有任務。
• 可以刪除集合箱中的任務。
• 支持創建新項目。

📦 安裝指南

先決條件

• Node.js (v14 或更高版本)
• npm 或 yarn
• Dida365（TickTick）賬戶

安裝步驟

我們建議您克隆倉庫並在本地運行，具體步驟如下：

1. 克隆此倉庫。
2. 安裝依賴項：

npm install

💻 使用示例

獲取您的令牌

1. 打開 https://developer.dida365.com/manage 並點擊“新建應用”，以創建您的 Dida365（TickTick）應用。
2. 點擊“編輯”應用，配置 OAuth 重定向 URL “http://106.75.247.14:3999/oauth/callback”。
3. 獲取您的客戶端 ID 和客戶端密鑰。
4. 打開 "https://dida365.com/oauth/authorize?scope=tasks%3Aread%20tasks%3Awrite&client_id={client_id}&state=state&redirect_uri=http%3A%2F%2F106.75.247.14%3A3999%2Foauth%2Fcallback&response_type=code"。 請記得將 {client_id} 替換為您自己的 client_id。服務器將返回一個表單。
5. 填寫您的客戶端 ID 和客戶端密鑰，然後提交以獲取您的令牌。

不同客戶端的配置

Cursor

1. 打開 Cursor 並轉到設置 > MCP。
2. 點擊“添加新的全局 MCP 服務”。
3. 將以下配置添加到 mcp.json 中：

"dida365": {
  "command": "cmd",
  "args": [
    "/c",
    "npx",
    "-y",
    "@smithery/cli@latest",
    "run",
    "@iamjzx/dida",
    "--config",
    "{\"token\":\"your token\"}"
  ]
}

4. 保存文件並啟用 MCP。

Claude Desktop

1. 打開 Claude Desktop 並轉到設置 > 開發者。
2. 啟用開發者模式。
3. 點擊“編輯配置”以打開您的 claude_desktop_config.json。
4. 在“mcpServers”部分添加以下配置：

"dida365": {
  "command": "cmd",
  "args": [
    "/c",
    "npx",
    "-y",
    "@smithery/cli@latest",
    "run",
    "@iamjzx/dida",
    "--config",
    "{\"token\":\"your token\"}"
  ]
}

5. 保存文件並重新啟動 Claude Desktop。

📚 詳細文檔

日誌

您可以在 src/server.log 文件中查看服務運行時日誌。

未完成的功能

由於 API 的限制，我們無法實現以下功能：

1. 獲取特定項目的任務。
2. 更新特定項目中的現有任務。
3. 刪除特定項目中的任務。
4. 在特定項目中創建新任務。