模型接入 (MCP/Agent)¶

本文为您介绍如何将 FIRERPA 与大模型进行对接（基于 MCP 或命令），FIRERPA 已在底层实现了 MCP 服务端协议以及 OpenAI 原生 tool-call 功能，支持您自行编写 MCP 插件并通过 65000 标准端口进行服务，或者继承 Agent 类实现全自动的 tools 调用。

内置 Agent 命令¶

通过内置 agent 命令可以快速通过大模型完成完全口语化的任务，支持任意兼容 OpenAI API + toolcall 的服务商或是自建服务。配合内置的 crontab，您可以实现口语化任务的定时运行。

提示

agent 命令需要在内置终端内使用，同时需要您提供有效的 API 以及秘钥。各个大模型的使用表现可能不一致，请选择最适合您的。我们推荐 gemini，openai，deepseek，glm 等。

参数名	类型	必填	默认值	说明
`--api`	字符串 (str)	是	-	API 端点
`--model`	字符串 (str)	是	-	模型名称
`--temperature`	浮点数 (float)	否	`0.2`	模型采样温度
`--key`	字符串 (str)	是	-	用于身份验证的 API 密钥
`--vision`	布尔值 (bool)	否	`False`	是否开启视觉模式
`--imsize`	整数 (int)	否	`1000`	视觉模式下的图像尺寸
`--prompt`	字符串 (str)	是	-	代理（Agent）执行的指令
`--max-tokens`	整数 (int)	否	`16384`	生成的最大 Token 数量
`--step-delay`	浮点数 (float)	否	`0.0`	步骤之间的延迟时间

注意

需要注意的是，参数 API 的地址是完整的地址，不是 base_url，通常需要在 base_url 后扩充 `/chat/completions` 拼接出完整的 API 地址。

准备好所需的信息后，您可以通过在远程桌面的终端输入如下命令来让 AI 自动操作您的设备。

agent --api https://generativelanguage.googleapis.com/v1beta/openai/chat/completions --key YOUR_API_KEY --model gemini-2.5-flash --prompt "帮我打开设置 APP，包名 com.android.settings，找到网络设置，开启飞行模式"

如果您的任务提示过长，也可以通过文件的方式提供模型提示词。

agent --api https://generativelanguage.googleapis.com/v1beta/openai/chat/completions --key YOUR_API_KEY --model gemini-2.5-flash --prompt /path/to/prompt.txt

Claude & Cursor 接入（MCP）¶

这个部分为您介绍如何将 FIRERPA 的 MCP 功能接入您的大模型客户端，我们只对 Claude 以及 Cursor 做了示例，您也可以在其他任意支持 MCP 协议的地方使用它。

备注

FIRERPA 内置 MCP 服务支持 tool-call，resource-read 以及 prompts 和进度通知及日志。

注意

请注意 8.0 服务端和 9.0 服务端的通信协议不同，9.x 为 streamable-http，8.x 为 sse。

安装官方扩展¶

我们为您提供了一个官方 MCP 服务，您可以在 extensions/firerpa.py 下载到此扩展模块，您也可以参考其编写方法自行编写或者扩展插件功能。下载扩展插件脚本后，通过远程桌面或者手动 push 将其上传到设备的 /data/usr/modules/extension 目录中，重启设备或重启 FIRERPA 服务即可。

注意

8.0 扩展脚本和 9.0 的扩展脚本不兼容，请严格确认您的服务端版本并从 github 分支拉取对应的脚本。

使用官方扩展¶

对于 Claude，您需要先找到 Claude 设置页面，并按照如下图示步骤进行操作。并根据提示，编辑 Claude 的 claude_desktop_config.json 配置文件，并写入如下的 MCP json 服务配置。

{"mcpServers": {"firerpa": {"command": "npx", "args": ["-y", "supergateway", "--streamableHttp", "http://192.168.0.2:65000/firerpa/mcp/"]}}}

对于 Cursor，您需要打开 Cursor Settings，按照图示进行操作，并输入如下配置。

{"mcpServers": {"firerpa": {"url": "http://192.168.0.2:65000/firerpa/mcp/"}}}

注意

请注意将配置中的链接换为您自己设备的 IP 地址。

编写 MCP 扩展¶

提示

文档 Comming soon. 敬请期待