MCP 工具
This content is not available in your language yet.
SRA-server 内置 Model Context Protocol(MCP)服务,AI 客户端(Claude Desktop、Cursor 等) 可以直接调用 SRA 的工具:截图、OCR、任务控制、游戏操作、配置与设置修改。
MCP 使用 Streamable HTTP,端点:
http://localhost:5073/mcp在支持远程 MCP 的客户端中添加:
{ "mcpServers": { "sra": { "url": "http://localhost:5073/mcp" } }}连接前请先启动服务端,并确保游戏窗口已就绪(本地模式要求 1920×1080 客户区)。
| 工具 | 参数 | 说明 |
|---|---|---|
sra_screenshot |
无 | 返回 720p JPEG 画面,并提示坐标需从 720p 换算到 1080p |
sra_startup |
无 | 启动后端;进程内模式下为幂等操作 |
sra_shutdown |
无 | 请求停止当前任务/扩展(进程内无子进程可结束) |
sra_restart |
无 | 进程内重新初始化 SRA 核心(重载任务、扩展与设置) |
| 工具 | 参数 | 说明 |
|---|---|---|
sra_task_list |
无 | 列出已注册任务(名称、顺序、类名、说明) |
sra_task_run |
configNames(空格分隔,可空) |
运行指定配置中的任务,留空运行全部 |
sra_task_single |
task、configName(可空) |
运行单个任务,task 支持名称或索引 |
sra_task_stop |
无 | 停止当前任务,空闲时返回失败提示 |
sra_task_status |
无 | 返回任务状态 JSON(含 success、message、data) |
Operator 与游戏操作
Section titled “Operator 与游戏操作”| 工具 | 参数 | 说明 |
|---|---|---|
sra_ocr |
fromX、fromY、toX、toY(均可空) |
OCR 识别,返回全部文本;坐标单位为 1080p 像素 |
sra_ocr_match |
text、区域坐标(可空) |
OCR 匹配,返回命中的文本 |
sra_click_point |
mode(abs / rel)、x、y |
点击坐标;abs 为分辨率像素,rel 为 0–1 比例 |
sra_scroll |
clicks、x、y(可空) |
滚轮滚动,正数向上、负数向下 |
sra_press_key |
key |
按键,支持 ctrl+c 这类组合 |
sra_hold_key |
key、duration(默认 1.0) |
长按指定秒数 |
sra_sleep |
seconds |
等待指定秒数(服务端等待,不阻塞其他请求) |
sra_operator_list |
无 | 列出全部 Operator 方法 |
sra_operator_help |
method |
查看方法签名、参数类型与文档 |
sra_operator_call |
method、parameters(JSON 字符串) |
调用任意 Operator 方法 |
sra_operator_call 的 parameters 是一个 JSON 对象字符串,例如:
{ "method": "click_point", "parameters": "{\"mode\": \"rel\", \"x\": 0.5, \"y\": 0.5}"}不确定参数时,先调用 sra_operator_list 与 sra_operator_help,不必猜。
| 工具 | 参数 | 说明 |
|---|---|---|
sra_get_logs |
count(默认 100) |
返回最近若干条日志文本 |
| 工具 | 参数 | 说明 |
|---|---|---|
sra_config_list |
无 | 返回配置名列表与当前配置 |
sra_config_get |
configName |
读取配置;用户名/密码会被掩码 |
sra_config_create |
configName |
注册新配置名(首次更新时才写文件) |
sra_config_update |
configName、patchJson |
用局部 JSON 打补丁,只修改给出的字段 |
sra_config_delete |
configName |
删除配置注册信息,磁盘上的配置文件保留 |
patchJson 的顶层键是配置分区,内层是带点号的字段键:
{ "cosmicStrife": { "currencyWars.runtimes": 3, "currencyWars.pointRewards": true }}startGame.username / startGame.password 接受明文,服务端加密后保存;未提供的字段保持不变。
| 工具 | 参数 | 说明 |
|---|---|---|
sra_settings_get |
无 | 读取应用设置(点号键,如 developerMode.customBackend.enabled) |
sra_settings_update |
patchJson |
用局部 JSON 打补丁,只修改给出的字段 |
{ "advanced": { "developerMode.customBackend.enabled": true }}截图 → 分析画面 → OCR 确认界面 → 点击/按键 → 再截图验证sra_screenshot获取画面(记住是 720p,换算到 1080p 后再点击);- 需要精确判断时用
sra_ocr/sra_ocr_match; - 用
sra_click_point/sra_press_key/sra_hold_key操作; - 用
sra_task_status、sra_get_logs确认执行情况。
