Ticktick MCP

🚀 咔嗒任務 MCP 服務

咔嗒任務 MCP 服務是一個基於 Model Context Protocol (MCP) 的服務器實現，專為集成 TickTick 任務管理工具而設計。藉助 Python 和 MCP SDK，它為 AI 助手與應用程序和 TickTick 的任務管理功能交互提供了標準化途徑。

🚀 快速開始

此存儲庫包含 TickTick 的 Model Context Protocol (MCP) 服務器實現，它提供了一種標準方式，使 AI 助手和應用程序能夠與 TickTick 的任務管理功能交互。通過此 MCP，AI 系統可以充當任務管理器，幫助您使用自然語言處理在 TickTick 中管理待辦事項和任務。

✨ 主要特性

• 任務操作全面：支持獲取項目和任務、創建新項目和任務、更新任務詳情以及完成和刪除任務等操作。
• 自然語言交互：AI 系統可藉助自然語言處理技術，在 TickTick 中管理待辦事項和任務。
• 功能可擴展性：能夠通過在 server.py 中添加新的命令處理函數並註冊，輕鬆擴展服務器功能。
• 廣泛兼容性：設計為與任何支持相同命令的客戶端兼容。

📦 安裝指南

先決條件

• Python 3.8+
• 咔嗒賬戶
• 咔嗒 API 密鑰（通過 OAuth）

安裝步驟

1. 克隆此倉庫

   git clone https://github.com/ekkyarmandi/ticktick-mcp.git
   cd ticktick-mcp
   

2. 安裝依賴項

   pip install -r requirements.txt
   

獲取 TickTick API 密鑰

此 MCP 使用了 TickTick 的 OpenAPI 方案，需要通過 TickTick 開發者門戶註冊應用：

1. 訪問 TickTick 開發文檔
2. 點擊右上角的 Manage Apps 並使用您的 TickTick 資格登錄
3. 點擊 +App Name 按鈕新建一個應用
4. 為您的應用輸入一個名稱（唯一必填字段）
5. 應用創建後，您將能夠看到您的 Client ID 和 Client Secret
6. 對於 OAuth Redirect URL，請輸入一個在授權後重定向的 URL（例如，http://127.0.0.1:8080）

授權您的應用

註冊應用後，使用 ticktick-py 庫獲取訪問令牌：

from ticktick.oauth2 import OAuth2

# 用您從開發者門戶獲得的詳細信息替換
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
redirect_uri = "YOUR_REDIRECT_URI"  # 例如，http://127.0.0.1:8080

auth_client = OAuth2(client_id=client_id,
                    client_secret=client_secret,
                    redirect_uri=redirect_uri)

# 這將打開瀏覽器進行授權
# 在終端中按照說明完成授權
auth_client.get_access_token()

授權完成後，訪問令牌將保存到默認的 .token-oauth 文件中。您可以通過以下方式提取令牌：

print(auth_client.token_info["access_token"])

配置

在根目錄創建一個 .env 文件，並在其中添加您的 TickTick API 密鑰：

TICKTICK_API_KEY=您的訪問令牌

💻 使用示例

基礎用法

運行 MCP 服務器：

python main.py

這將在端口 8000 上啟動 MCP 服務器。您可以通過以下方式與服務器交互。

提供的工具

• tick.tick(): 返回當前時間的時間字符串。
• time.travel(seconds): 時間旅行功能，將當前時間向前或向後移動指定秒數。

示例交互

1. 獲取當前時間：

$ python main.py tick.tick

2. 將時間向前移動 60 秒：

$ python main.py time.travel 60

3. 再次獲取當前時間：

$ python main.py tick.tick

🔧 技術細節

擴展性

要擴展 MCP 服務器，請在 server.py 中添加新的命令處理函數，並在 main() 函數中註冊它們。

def new_command():
    # 在此處實現新功能
    pass

if __name__ == "__main__":
    register_command("new_command", new_command)

兼容性

此 MCP 服務器設計為與任何支持相同命令的客戶端兼容。要創建自定義命令，請按照以下步驟操作：

1. 定義新函數。
2. 在 server.py 中註冊該函數。

def custom_function():
    # 實現功能
    pass

if __name__ == "__main__":
    register_command("custom_function", custom_function)

通過遵循這些步驟，您可以輕鬆擴展 MCP 服務器的功能以滿足您的需求。