Ticktick MCP

🚀 カツカツタスク MCP サービス

このプロジェクトは、TickTick タスク管理ツールとの統合を目的とした、Model Context Protocol (MCP) サーバーの実装です。Python と MCP SDK を使用して機能を提供しています。

🚀 クイックスタート

この MCP サーバーを使用することで、AI アシスタントやアプリケーションが TickTick のタスク管理機能とやり取りできるようになります。以下の操作がサポートされています。

• プロジェクトとタスクの取得
• 新しいプロジェクトとタスクの作成
• タスク詳細の更新
• タスクの完了と削除

✨ 主な機能

• AI システムが自然言語処理を使って TickTick 内のタスク管理を支援できます。
• 提供されるツールには、現在時刻を返す tick.tick() や、時間を移動させる time.travel(seconds) があります。

📦 インストール

前提条件

• 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"])

設定

1. ルートディレクトリに .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 サーバーの機能を簡単に拡張して、あなたのニーズに合わせることができます。