🚀 点动点 (TickTick) MCP 服务器
这是一个用于与 TickTick 应用程序交互的 MCP（多功能控制处理器）服务器。它允许通过命令行或其他集成方式自动化和管理 TickTick 的任务、提醒和其他功能。
🚀 快速开始
本服务器可让你通过命令行或其他集成方式，对 TickTick 的任务、提醒等功能进行自动化管理。下面为你介绍使用该服务器的具体步骤。
✨ 主要特性
TickTick API 功能
- 管理任务和提醒：可通过 REST 或 RPC 接口创建、更新、删除和查询任务。
- 时区和日历集成：支持多种时区，还能与 Google Calendar 等第三方日历服务集成。
- 批量操作：支持批量创建、更新或删除多个任务，也能将数据导出为 CSV 或 JSON 格式。
📦 安装指南
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
💻 使用示例
基础用法
在 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. 第一次授权流程
首次运行服务器时，您需要完成授权流程：
- MCP 服务器会打开浏览器并重定向到 TickTick 登录页面。
- 使用您的 TickTick 账户登录。
- 授予应用程序所需的权限。
- 生成的访问令牌将显示在浏览器中，请将其复制并设置为环境变量
TICKTICK_ACCESS_TOKEN。
TickTick 开发者控制台
访问 TickTick 开发者门户
您可以通过以下链接访问 TickTick 的开发者控制台：https://developer.ticktick.com/manage。
创建应用并获取凭据
- 登录后转到“应用管理”页面。
- 点击“创建新应用”。
- 填写应用信息并提交。
- 在应用详情页中，找到
CLIENT_ID和CLIENT_SECRET。
常见问题解答
如何生成新的访问令牌？
- 在 TickTick 开发者控制台中，转到“凭据”页面。
- 点击“生成新令牌”。
- 按照提示完成验证流程并获取新的访问令牌。
服务器无法启动怎么办？
- 检查环境变量是否正确配置。
- 确保网络连接正常。
- 查看控制台输出以获取错误信息。
🔧 技术细节
TickTick MCP 服务器借助命令行或其他集成方式，实现对 TickTick 应用任务、提醒等功能的自动化管理。它支持多种时区，能与第三方日历服务集成，还可进行批量任务操作和数据导出。通过 REST 或 RPC 接口，可方便地对任务进行创建、更新、删除和查询等操作。
📄 许可证
此 MCP 服务器根据 MIT 许可证分发。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款。有关详细信息，请参阅项目仓库中的 LICENSE 文件。
⚠️ 重要提示
- 确保将
.env文件添加到.gitignore，避免敏感信息被提交到版本控制系统。- 定期更新访问令牌以减少安全风险。