Tasker MCP

🚀 Tasker MCP 使用指南

本指南將指導您如何設置並運行 Tasker MCP 集成，涵蓋安裝依賴項、準備服務器以及更新任務的詳細說明，助您輕鬆實現自動化操作。

🚀 快速開始

按照以下步驟，您可以輕鬆完成 Tasker MCP 的集成和配置：

1. 安裝依賴：確保已安裝 Node.js 和相關工具。
2. 設置服務器：按照後續詳細步驟準備並運行 MCP 服務器。
3. 更新任務：配置自定義任務，確保變量和動作正確無誤。
4. 導出項目：導出項目並生成 toolDescriptions.json 文件以供服務器使用。

💻 使用示例

第一步：導入 Tasker 個人資料

• 將 dist/mcp_server.prj.xml 導入到您的 Tasker 應用中。
• 成功導入後，運行 MCP generate_api_key 任務以生成用於安全訪問的 API Key。

第二步：選擇並運行服務器

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（服務器發送事件）模式運行。

第三步：更新 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 文件與服務器。

第四步：配置任務變量

1. 步驟 1：為每個自定義任務添加任務評論，確保內容準確反映工具功能。
2. 步驟 2：在任務中正確配置工具變量（如類型、默認值等），以確保導出時生成有效的工具描述。
3. 步驟 3：將 MCP#parse_args 動作複製到 MCP 任務的頂部，以啟用參數解析功能。

祝您自動化愉快！