Tasker MCP

Tasker MCP

site icon
2025.03.11 10
Go自动化任务管理Tasker 集成开发效率
Tasker MCP 是一个用于自动化任务管理的服务,通过与 Tasker 应用集成,提供任务执行和管理的功能。它支持多种传输模式(SSE 和 stdio),并允许用户通过 API 密钥进行安全访问。
View on GitHub

Overview

基本能力

产品定位

Tasker MCP 是一个自动化任务管理服务,主要用于与 Tasker 应用集成,提供任务执行和管理的功能。

核心功能

  1. 任务管理:支持导入、生成和更新任务。
  2. 多种传输模式:支持 SSE 和 stdio 两种传输模式。
  3. API 密钥管理:生成和管理 API 密钥以确保安全访问。
  4. 跨平台支持:提供不同架构的 CLI 服务器二进制文件。

适用场景

  1. 自动化任务执行:通过 CLI 或 API 调用执行 Tasker 任务。
  2. 跨设备任务管理:在手机或 PC 上运行任务。
  3. 开发集成:与 MCP 支持的应用程序集成,如 Claude Desktop。

工具列表

  1. tasker-mcp-server-cli:CLI 服务器二进制文件,支持不同架构。
  2. toolDescriptions.json:包含 Tasker 工具定义的 JSON 文件。
  3. xml-to-tools.js:用于从导出的 XML 文件生成工具描述的 Node.js 脚本。

常见问题解答

  1. 如何生成 API 密钥:运行 MCP generate_api_key 任务。
  2. 如何更新工具描述:使用 xml-to-tools.js 脚本从导出的 XML 文件生成新的 toolDescriptions.json
  3. 如何配置任务参数:通过 Task Variables 设置参数,并确保正确配置元数据。

使用教程

使用依赖

  1. 安装 Go(用于构建 CLI 服务器): bash sudo apt-get install golang-go
  2. 安装 Node.js(用于生成工具描述): bash sudo apt-get install nodejs

安装教程

  1. 导入 Tasker Profile
  2. 导入 dist/mcp_server.prj.xml 到 Tasker 应用。
  3. 运行 MCP generate_api_key 任务生成 API 密钥。

  4. 运行 CLI 服务器

  5. dist/ 文件夹选择适合的 CLI 服务器二进制文件。
  6. 复制二进制文件和 toolDescriptions.json 到设备。
  7. 重命名二进制文件为 mcp-server
  8. 运行服务器(SSE 模式): bash ./mcp-server --tools /path/to/toolDescriptions.json --tasker-api-key=tk_... --mode sse
  9. 或通过 stdio 传输调用: bash 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_...

调试方式

  1. 检查服务器运行状态:确保服务器正在监听指定的主机和端口。
  2. 验证 API 密钥:确保使用正确的 API 密钥调用服务器。
  3. 检查工具描述文件:确保 toolDescriptions.json 文件路径正确且内容有效。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。