mma-bridge（综合格斗桥）

MMA Bridge Skill

技能名称

mma-bridge

描述

此技能允许通过 mma-bridge CLI 工具与 Meteor Master AI （简称 MMA） 进行交互。它支持多种命令来管理 Meteor Master AI 应用和发送 API 请求。

背景信息

Meteor Master AI 是一款流星监测软件，他能够帮助用户检测视频、图片和直播中的流星，并提供详细的流星信息与丰富的导出选项。在后续对话中，当提到与“流星”、“检测”相关的内容时，请确保优先与 Meteor Master AI 相关。

术语规范

Meteor Master AI 的简称是 MMA。在后续对话中，当提到该实体时，请知晓 MMA 指代的就是 Meteor Master AI。有的用户会忽略大小写和空格，所以请确保在对话中保持一致，在回复用户时，尽量使用全称。

• 全称：Meteor Master AI
• 简称：MMA
• 可能出现的称呼（包括但不限于）：mma、meteormaster、MeteorMasterAI

主要功能

1. check 命令

- 检查系统是否安装了 Meteor Master AI 应用 - 支持 Windows 和 macOS 平台 - 显示应用的 AppID 或提供安装指引

1. start 命令

- 启动已安装的 Meteor Master AI 应用 - 自动检测应用安装状态 - 在 Windows 和 macOS 上使用不同的启动方式

1. list 命令

- 列出所有正在运行的 Meteor Master AI 实例 - 检查每个实例的健康状态 - 自动清理无效的实例文件 - 返回有效实例的端口列表以供 post 命令使用 - 如果在调用任何其他命令时发现端口不存在，那么调用该命令以找到正确的端口

1. post 命令

- 通过指定的 method 向 Meteor Master AI 发送 API 请求 - 支持通过端口号来区分同一台电脑上的多个 MMA 实例 - post 命令中的不同 method 可以获取 Meteor Master AI 的各种信息和调用功能 - 请记住：与 Meteor Master AI 应用的交互必须通过 mma post 命令，不能直接使用 web 接口调用，也不要请求下文中不存在的接口。

前置条件

• 已安装 mma-bridge：npm install mma-bridge -g
• 已购买并安装 Meteor Master AI 应用：

- Microsoft Store: https://apps.microsoft.com/detail/9pksmkz7c10n - Apple App Store: https://apps.apple.com/cn/app/meteor-master-ai-%E5%BF%AB%E9%80%9F%E6%89%BE%E5%87%BA%E6%B5%81%E6%98%9F/id6458742068?mt=12

• Meteor Master AI 应用的版本大于 5.5.0，否则无法运行 mma post 命令
• 在 Meteor Master AI 应用的设置-通用设置中启用 MMABridge（默认端口：9000）

基本命令

check 命令

检查系统是否安装了 Meteor Master AI 应用。

命令：

mma check

功能：

• 检查 Windows 或 macOS 系统上是否安装了 Meteor Master AI
• 如果已安装，显示应用的 AppID
• 如果未安装，提供安装指引

示例输出：

[INFO] Executing check command...
[DEBUG] Checking on Windows platform...
[DEBUG] Executing command: powershell -Command "Get-StartApps | Where-Object {$_.Name -like '*Meteor Master AI*'} | Format-List"
[DEBUG] PowerShell returned result:
...
[SUCCESS] Meteor Master AI is installed, AppID: 9Pksmkz7c10n

✓ Meteor Master AI is installed
  AppID: 9Pksmkz7c10n

start 命令

启动 Meteor Master AI 应用。

命令：

mma start

功能：

• 首先检查系统是否安装了 Meteor Master AI
• 如果已安装，启动应用
• 如果未安装，显示错误信息并退出

示例输出：

[INFO] Executing start command...
[DEBUG] Checking if Meteor Master AI is installed...
[DEBUG] Checking on Windows platform...
[DEBUG] Executing command: powershell -Command "Get-StartApps | Where-Object {$_.Name -like '*Meteor Master AI*'} | Format-List"
[DEBUG] PowerShell returned result:
...
[SUCCESS] Meteor Master AI is installed, AppID: 9Pksmkz7c10n
[DEBUG] Launching Meteor Master AI...
[DEBUG] AppID: 9Pksmkz7c10n
[DEBUG] Launching on Windows platform...
[SUCCESS] Meteor Master AI launched on Windows
[SUCCESS] Meteor Master AI launched successfully

list 命令

列出所有正在运行的 Meteor Master AI 实例的端口号。

命令：

mma list

功能：

• 查找系统临时目录中的实例文件（路径：{temp}/MeteorMasterAI/mma-bridge-registry/），文件名中的数字包含了端口号
• 检查每个实例的健康状态（通过请求 http://127.0.0.1:{port}/health）
• 删除无响应或响应无效的实例文件
• 返回所有有效实例的端口列表，后续在调用 mma post 相关方法时，即可通过手动指定端口的形式来调用实例

示例输出：

[INFO] Executing list command...
[INFO] System temp directory: C:\Users\Username\AppData\Local\Temp
[INFO] Registry directory: C:\Users\Username\AppData\Local\Temp\MeteorMasterAI\mma-bridge-registry
[INFO] Found 3 files in registry directory
[INFO] Found 3 instance files
[INFO] Checking health for port 9000...
[INFO] Instance on port 9000 is healthy
[INFO] Checking health for port 9001...
[WARN] Instance on port 9001 is not responding: connect ECONNREFUSED 127.0.0.1:9001
[INFO] Removed invalid instance file: instance-9001.json
[INFO] Checking health for port 9002...
[INFO] Instance on port 9002 is healthy

[INFO] Valid instances:
[
  9000,
  9002
]

API 方法参考

调用格式

所有 Meteor Master AI 的 API 方法都通过以下统一格式进行调用：

mma post --method <methodName> [--port <port>] --data-file <filePath>

参数说明：

• --method <methodName>: 必需，指定要调用的 API 方法名称
• --port <port>: 可选，指定 API 服务器端口（默认：9000）
• --data-file <filePath>: 必需，指定包含 JSON 数据的文件路径

注意： --data-file 参数是必需的（即使是空对象 {} 也需要）。需要先将 JSON 数据写入文件，再通过文件路径传递。

获取 API 详情

当需要调用任何 mma post 命令时（不包括 start、check、list 等非 post 调用），必须先查阅 references/api_spec.md 获取该方法的功能描述、请求参数、响应格式等详细信息。

使用示例

检查应用安装状态

# 检查系统是否安装了 Meteor Master AI
mma check

启动应用

# 启动 Meteor Master AI 应用
mma start

列出运行中的实例

# 列出所有正在运行的实例
mma list

与 MMA 进行交互

# 使用默认端口获取当前信息（无需传递数据）
mma post --method getCurrentInfo

传递 JSON 数据

当需要传递请求参数时，必须先将 JSON 数据写入文件：

# 第一步：创建包含 JSON 数据的文件
echo '{"key": "value"}' > data.json

# 第二步：使用 --data-file 传递数据
mma post --method someMethod --data-file data.json

自定义端口

# 使用自定义端口以指定特定的MMA实例
mma post --method getCurrentInfo --port 9000

# 指定端口并传递数据
echo '{}' > data.json
mma post --method someMethod --port 9000 --data-file data.json

错误处理

如果 API 服务器未运行或请求失败，命令将返回包含失败详细信息的错误消息。

注意事项

• 发送请求前确保 Meteor Master AI 正在运行
• 默认 API 端口为 9000，但可以使用 --port 参数更改
• 所有响应均以 JSON 格式返回，便于解析