Tasker MCP 使用指南

本指南将指导您如何设置并运行 Tasker MCP 集成，包括安装依赖项、准备服务器以及更新任务的说明。

使用说明

第一步：导入 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：为每个自定义任务添加任务评论，确保内容准确反映工具功能。
• 步骤 2：在任务中正确配置工具变量（如类型、默认值等），以确保导出时生成有效的工具描述。
• 步骤 3：将 MCP#parse_args 动作复制到 MCP 任务的顶部，以启用参数解析功能。

快速入门

通过以上步骤，您可以轻松完成 Tasker MCP 的集成和配置。以下是一个简要的快速入门指南：

1. 安装依赖：

   • 确保已安装 Node.js 和相关工具。

2. 设置服务器：

   • 按照上述步骤准备并运行 MCP 服务器。

3. 更新任务：

   • 配置自定义任务，确保变量和动作正确无误。

4. 导出项目：

   • 导出项目并生成 toolDescriptions.json 文件以供服务器使用。

祝您自动化愉快！