MCP Ticktick

🚀 咔嗒鱼 MCP サーバー

これは TickTick 用に作成された モデルコンテキストプロトコル (MCP) サーバーです。Claude や他の MCP クライアントを通じて、直接 TickTick のタスク管理システムとやり取りすることができます。

✨ 主な機能

• 📋 すべての TickTick プロジェクトとタスクを表示
• ✏️ 自然言語で新しいプロジェクトとタスクを作成
• 🔄 既存のタスク詳細（タイトル、内容、日付、優先度）を更新
• ✅ タスクを完了としてマーク
• 🗑 タスクを削除
• 🔧 新しいプロジェクトを作成
• 🗙 プロジェクトを削除

📦 インストール

前提条件

このプロジェクトを実行する前に、以下のソフトウェアとツールがインストールされていることを確認してください。

• Python 3.8 以上
• pip（Python パッケージマネージャー）

インストール手順

1. プロジェクトフォルダをダウンロードして解凍します。
2. プロジェクトのルートディレクトリに config フォルダを作成し、その中に TickTick API キー (app_key) とシークレットキー (app_secret) を配置します。
3. ターミナルまたはコマンドプロンプトを開き、プロジェクトのルートディレクトリに移動します。
4. すべての依存関係をインストールするために、以下のコマンドを実行します。

pip install -r requirements.txt

5. サーバーを起動します。

python ticktick_mcp/ticktick_client.py

📚 ドキュメント

認証フロー

1. サーバーを起動すると、TickTick の承認ページにリダイレクトされます。
2. TickTick アカウントにログインし、必要な権限を付与します。
3. 生成された承認コードをコピーし、サーバーのプロンプトに貼り付けます。

使用例

基本的な使用法

# すべてのプロジェクトを表示
curl http://localhost:5000/projects

# 新しいタスクを作成
curl -X POST -H "Content-Type: application/json" -d '{"title":"完成 MCP 服务器文档","project_id":"your_project_id","priority":"high"}' http://localhost:5000/tasks

# タスクを完了としてマーク
curl -X PUT -H "Content-Type: application/json" -d '{"project_id":"your_project_id", "task_id":"task_id"}' http://localhost:5000/complete_task

# プロジェクトを削除
curl -X DELETE -H "Content-Type: application/json" -d '{"project_id":"your_project_id"}' http://localhost:5000/delete_project

開発ガイド

プロジェクト構造

ticktick-mcp/
├── .env.template          # 環境変数テンプレート
├── README.md              # プロジェクトドキュメント
├── requirements.txt       # プロジェクトの依存関係
├── setup.py               # パッケージ設定ファイル
├── test_server.py         # テストスクリプト
└── ticktick_mcp/          # メインプログラムパッケージ
    ├── __init__.py        # パッケージ初期化
    ├── authenticate.py    # OAuth 認証ツール
    ├── cli.py             # コマンドラインインターフェイス
    └── src/               # ソースコード
        ├── __init__.py    # モジュール初期化
        ├── auth.py        # OAuth 認証の実装
        ├── server.py      # MCP サーバーの実装
        └── ticktick_client.py  # TickTick API クライアント

コントリビューションガイド

コントリビューションを歓迎します！以下の手順に従ってプルリクエストを送信してください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add some amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを送信します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。