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. 在特定项目中创建新任务。