Meteor Master AI Bridge

通过 mma-bridge 命令行工具与 Meteor Master AI 交互

Security Scan

The skill is an instruction-only guide for using a local mma-bridge CLI to talk to a local Meteor Master AI application; its requirements and actions are coherent with that purpose, with one minor metadata omission (the skill actually depends on a CLI that the registry metadata did not declare).

Purpose & Capability

The SKILL.md clearly describes interacting with a local mma-bridge CLI and a local Meteor Master AI (MMA) app. However the registry metadata claims 'no required binaries' while the instructions require the mma CLI (via `npm install mma-bridge -g`) and a locally installed Meteor Master AI app. This is a metadata omission but not a functional mismatch.

Instruction Scope

Runtime instructions are limited to checking/starting/listing local MMA instances, reading a temp/registry directory, and sending HTTP requests to localhost ports (e.g., /health) or invoking the mma CLI (mma post). The instructions do not instruct the agent to read unrelated system secrets or exfiltrate data to external endpoints.

Install Mechanism

The skill is instruction-only (no install spec). SKILL.md recommends installing `mma-bridge` via `npm install -g`, which means the user will install a third-party npm package; the registry did not provide an install spec or provenance. Instruction-only status reduces platform install risk, but installing an external npm package from an unknown publisher is a separate operational risk the user should evaluate.

Credentials

The skill declares no environment variables and does not request credentials. It works with local files, temp directories, and localhost service ports, which are proportional to the stated purpose of controlling a local MMA application. Example data includes an RTSP URL with credentials — those are examples and not requested by the skill, but users should avoid pasting real secrets into commands.

Persistence & Privilege

The skill does not request persistent/always-on privileges (always:false). It does not modify other skills or system-wide agent settings in the provided instructions. Autonomous invocation is allowed by default but is not excessive here.

Assessment

This skill is an instructions-only adapter for a local CLI (mma-bridge) and a locally installed Meteor Master AI app. Before installing/using: 1) Confirm you actually want to install the `mma-bridge` npm package and verify its publisher and source on the npm registry (running `npm install -g` from an unknown package is a risk). 2) Understand the skill will list and query local MMA instances, read files in your temp directory, and call localhost HTTP endpoints (ports like 9000); these actions are expected for this use case. 3) Do not paste real credentials into example commands (RTSP examples include credentials). 4) If you are concerned, run the npm package in a sandboxed environment or inspect the package code before installing. The registry metadata should ideally declare the mma binary dependency — treat that omission as a documentation gap rather than malicious behavior.

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 或提供安装指引

2. start 命令

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

3. list 命令

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

4. 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 '<json>']

参数说明：

• --method <methodName>: 必需，指定要调用的 API 方法名称
• --port <port>: 可选，指定 API 服务器端口（默认：9000）
• --data '<json>': 可选，指定 JSON 格式的请求数据

API 方法 methodName列表

getCurrentInfo

请参考 getCurrentInfo.md

getFilterList

请参考 getFilterList.md

getDataList

请参考 getDataList.md

getDataDetail

请参考 getDataDetail.md

exportTrackImg

请参考 exportTrackImg.md

exportGroupVideo

请参考 exportGroupVideo.md

其他方法

此处将添加更多 API 方法，所有方法都使用相同的调用格式：

mma post --method <methodName> [--port <port>] [--data '<json>']

注意：

重要！具体可用的方法的详细参数必须仔细阅读每个API接口的详细说明，就在这个SKILL的同一文件夹下，一定要仔细熟读！ 随着应用版本的更新，可能会添加新的方法或修改现有方法的参数。

使用示例

检查应用安装状态

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

启动应用

# 启动 Meteor Master AI 应用
mma start

列出运行中的实例

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

与 MMA 进行交互

# 使用默认端口获取当前信息
mma post --method getCurrentInfo

自定义端口

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

错误处理

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

注意事项

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