Ticktick Mcpserver

🚀 🛠️ TicTick MCP 服務器

這是 TickTick（一款流行的待辦事項管理應用）的 Model Context Protocol (MCP) 服務器實現。該服務器能讓 AI 助手藉助 TickTick 開放 API 與 TickTick 進行交互。

🚀 快速開始

先決條件

• Node.js（v18 或更高版本）
• TickTick 開發者賬戶
• TickTick API 訪問令牌

安裝

1. 克隆此倉庫：

git clone https://github.com/shidhincr/ticktick-mcpserver.git
cd ticktick-mcpserver

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

4. 設置環境變量（請將 your_access_token_here 換為你的訪問令牌）：

export TICKTICK_ACCESS_TOKEN=your_access_token_here

5. 運行服務器。

✨ 主要特性

• 從項目中獲取任務
• 創建新任務（可指定截止日期、優先級和描述）
• 更新現有任務
• 標記任務為完成
• 刪除任務
• 獲取所有項目的列表
• 創建自定義屬性的新項目

📦 安裝指南

克隆倉庫

git clone https://github.com/shidhincr/ticktick-mcpserver.git
cd ticktick-mcpserver

安裝依賴

npm install

構建項目

npm run build

設置環境變量

export TICKTICK_ACCESS_TOKEN=your_access_token_here

📚 詳細文檔

📌 認證設置

要使用 TickTick API，需要進行身份驗證。以下是 OAuth2 流程的簡要說明：

1. 獲取授權 URL 並重定向用戶。
2. 用戶登錄後，TickTick 會返回一個授權碼。
3. 使用授權碼獲取訪問令牌。

🛠️ 可用工具

創建新項目

{
  "name": "新建項目名稱",
  "color": "#F18181", // 可選：顏色代碼
  "view_mode": "list", // 可選：視圖模式（"list", "kanban", "timeline"）
  "kind": "TASK" // 可選：項目類型（"TASK", "NOTE"）
}

更新現有項目

{
  "name": "更新後的項目名稱",
  "color": "#F18181"
}

📁 項目結構

ticktick-mcpserver/
├── dist/                     # 編譯生成的 TypeScript 文件（構建後生成）
├── src/
│   └── index.ts              # 主服務器實現文件
├── package.json              # 項目依賴和腳本
├── tsconfig.json             # TypeScript 配置文件
└── README.md                 # 文檔

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。

1. 叉取倉庫。
2. 創建功能分支（git checkout -b feature/amazing-feature）。
3. 提交更改（git commit -m '添加神奇的功能'）。
4. 推送到分支（git push origin feature/amazing-feature）。
5. 打開 Pull Request。

📚 API 參考

該項目使用 TickTick 開放 API。有關詳細信息，請參閱官方文檔。

📄 許可證

本項目在 MIT License 下許可，詳情請見 LICENSE 文件。

🙏 感謝

感謝以下項目的貢獻：

• TickTick 提供 API
• 模型上下文協議（MCP） 提供協議規範