Tasker MCP

🚀 Tasker MCP 使用ガイド

このガイドでは、Tasker MCP 統合の設定と実行方法を説明します。これには、依存関係のインストール、サーバーの準備、およびタスクの更新に関する説明が含まれます。

🚀 クイックスタート

上記の手順に従えば、Tasker MCP の統合と設定を簡単に完了できます。以下は簡単なクイックスタートガイドです。

1. 依存関係のインストール：

   • Node.js と関連ツールがインストールされていることを確認してください。

2. サーバーの設定：

   • 上記の手順に従って、MCP サーバーを準備して実行します。

3. タスクの更新：

   • カスタムタスクを構成し、変数とアクションが正しいことを確認します。

4. プロジェクトのエクスポート：

   • プロジェクトをエクスポートし、サーバーで使用する toolDescriptions.json ファイルを生成します。

✨ 主な機能

本ガイドを通じて、Tasker MCP の以下の機能を利用できます。

• Tasker 個人用プロファイルのインポート
• 安全なアクセスのための API Key の生成
• 複数のサーバーモードでの運用
• MCP 個人用プロファイルの更新
• タスク変数の設定

📦 インストール

ステップ 1：Tasker 個人用プロファイルのインポート

• dist/mcp_server.prj.xml をあなたの Tasker アプリにインポートします。
• インポートが成功したら、MCP generate_api_key タスクを実行して、安全なアクセスに使用する API Key を生成します。

ステップ 2：サーバーの選択と実行

CLI サーバー：

• dist/ フォルダから、あなたのデバイスアーキテクチャに適した CLI サーバーバイナリファイルを選択します。例えば、tasker - mcp - server - cli - aarch64 です。
• このバイナリファイルと toolDescriptions.json ファイルをあなたのデバイス（携帯電話または PC）にコピーします。
• コピーが完了したら、バイナリファイルを mcp - server にリネームします。

例： scp を使用する場合：

scp dist/tasker-mcp-server-cli-aarch64 user@phone_ip:/data/data/com.termux/files/home/mcp-server

adb push を使用する場合：

adb push dist/tasker-mcp-server-cli-aarch64 /data/data/com.termux/files/home/mcp-server

• SSE モードでサーバーを実行するには：

./mcp-server --tools /path/to/toolDescriptions.json --tasker-api-key=tk_... --mode sse

• または、stdio トランスポートを介して呼び出すには：

payload='{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "tasker_flash_text", "arguments": { "text": "Hi" }  } }'
echo $payload | ./mcp-server --tools /path/to/toolDescriptions.json --tasker-api-key=tk_...

コマンドラインフラグ

tasker - mcp - server - cli アプリケーションは、以下のフラグをサポートしています。

• --tools：Tasker ツール定義を含む JSON ファイルのパス。
• --tasker - api - key：認証に使用する Tasker API Key。
• --mode sse：SSE（サーバー送信イベント）モードで実行します。

ステップ 3：MCP 個人用プロファイルの更新

1. プロジェクトのエクスポート：

   • mcp_server.prj.xml ファイルをエクスポートし、コンピューターに保存します。

2. ツール説明ファイルの生成：

   • Node.js がインストールされていることを確認し、utils フォルダで以下のコマンドを実行します。

cd utils
npm install
node xml - to - tools.js /path/to/your/exported/mcp_server.prj.xml > toolDescriptions.json

• 生成された toolDescriptions.json ファイルをサーバーで使用します。

ステップ 4：タスク変数の設定

• ステップ 1：各カスタムタスクにタスクコメントを追加し、内容がツールの機能を正確に反映するようにします。
• ステップ 2：タスク内でツール変数（タイプ、デフォルト値など）を正しく構成し、エクスポート時に有効なツール説明が生成されるようにします。
• ステップ 3：MCP#parse_args アクションを MCP タスクの先頭にコピーして、パラメーター解析機能を有効にします。

自動化を楽しんでください！