Dida365（TickTick）MCP 服务端

这是一个提供与 Dida365（TickTick）API 交互工具的 Model Context Protocol (MCP) 服务器。在用户授权后，它允许 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. 在特定项目中创建新任务