🚀 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 任务的顶部，以启用参数解析功能。

祝您自动化愉快！