🚀 点动点 (TickTick) MCP 服务器

这是一个用于与 TickTick 应用程序交互的 MCP（多功能控制处理器）服务器。它允许通过命令行或其他集成方式自动化和管理 TickTick 的任务、提醒和其他功能。

🚀 快速开始

若要使用点动点 (TickTick) MCP 服务器，需先完成安装和配置，以下为你详细介绍操作步骤。

📦 安装指南

1. 安装依赖

确保已安装 Node.js 和 npm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install --lts
npm install -g @alexarevalo.ai/mcp-server-ticktick

2. 运行 MCP 服务器

运行以下命令启动服务器：

npx @alexarevalo.ai/mcp-server-ticktick start

✨ 主要特性

管理任务和提醒

• 创建任务：通过 REST 或 RPC 接口添加新的任务或提醒。
• 更新任务：修改现有任务的状态、优先级或其他属性。
• 删除任务：通过指定的任务 ID 删除任务。
• 查询任务：搜索特定的任务或按标签分类。

时区和日历集成

• 支持多种时区，确保全球用户都能正确同步时间。
• 集成 Google Calendar 和其他第三方日历服务。

批量操作

• 批量创建、更新或删除多个任务。
• 导出数据到 CSV 或 JSON 格式以便进一步处理。

💻 使用示例

示例：Claude Desktop 配置

在 Claude Desktop 中配置 TickTick MCP 服务器：

{
  "mcpServers": [
    {
      "name": "ticktick-mcp",
      "type": "custom",
      "host": "localhost",
      "port": "3000",
      "protocol": "http"
    }
  ]
}

📚 详细文档

配置 TickTick MCP 服务器

1. 环境变量配置

创建一个 .env 文件并添加以下内容：

TICKTICK_CLIENT_ID=your_client_id
TICKTICK_CLIENT_SECRET=your_client_secret
TICKTICK_ACCESS_TOKEN=your_access_token

2. 第一次授权流程

首次运行服务器时，您需要完成授权流程：

1. MCP 服务器会打开浏览器并重定向到 TickTick 登录页面。
2. 使用您的 TickTick 账户登录。
3. 授予应用程序所需的权限。
4. 生成的访问令牌将显示在浏览器中，请将其复制并设置为环境变量 TICKTICK_ACCESS_TOKEN。

TickTick 开发者控制台

访问 TickTick 开发者门户

您可以通过以下链接访问 TickTick 的开发者控制台：https://developer.ticktick.com/manage。

创建应用并获取凭据

1. 登录后转到“应用管理”页面。
2. 点击“创建新应用”。
3. 填写应用信息并提交。
4. 在应用详情页中，找到 CLIENT_ID 和 CLIENT_SECRET。

常见问题解答

如何生成新的访问令牌？

1. 在 TickTick 开发者控制台中，转到“凭据”页面。
2. 点击“生成新令牌”。
3. 按照提示完成验证流程并获取新的访问令牌。

服务器无法启动怎么办？

• 检查环境变量是否正确配置。
• 确保网络连接正常。
• 查看控制台输出以获取错误信息。

🔧 技术细节

TickTick MCP 服务器通过与 TickTick 应用程序的 API 进行交互，实现了对任务和提醒的自动化管理。它支持多种接口调用方式，如 REST 和 RPC，方便用户根据自己的需求进行集成。同时，服务器还支持多种时区和日历集成，确保全球用户都能正常使用。

📄 许可证

此 MCP 服务器根据 MIT 许可证分发。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款。有关详细信息，请参阅项目仓库中的 LICENSE 文件。

⚠️ 重要提示

• 确保将 .env 文件添加到 .gitignore，避免敏感信息被提交到版本控制系统。
• 定期更新访问令牌以减少安全风险。

总结

TickTick MCP 服务器为您提供了一种强大的方式来自动化和管理 TickTick 应用程序的任务和提醒功能。通过简单的命令行接口或 RPC 调用，您可以轻松实现任务的批量操作、日历集成以及其他高级功能。