andrew-babo/muse4ai

项目介绍

Muse4AI 运行在 Windows 电脑上，把本机已登录的 Muse 会话包装成 AI 智能体可调用的接口。ChatGPT、Claude、Cursor、Codex、n8n 或自写脚本可以通过 REST、MCP 或 OAuth 发起图片和视频生成、继续或延长视频、用自然语言描述来剪辑视频，以及带附件的多轮对话。媒体库、任务队列、API 密钥、OAuth 令牌和历史都保存在本机 %APPDATA%\MuseStudio，请求由本机直接发往 Muse，不经过项目方自建的中转服务器 整体架构说明。

连接智能体有两种方式。API 密钥在应用内创建，按范围授权、限流并可单独撤销，以 bearer token 发送。OAuth 则提供授权服务器元数据、动态客户端注册和屏幕上的 6 位数字确认码，只拿到链接的人无法自行授权 OAuth 连接方式。REST 接口覆盖任务创建、列表、查询、取消、素材与对话延长、状态和健康检查；对应的 MCP 工具包括 muse_generate、muse_chat、muse_extend_video 等 接口与工具对照。

快速使用

需要 Windows 10/11 和一个 Muse 账号。使用安装包时，从下载页获取安装程序并运行，然后在 Accounts 中添加 Muse 账号。Windows 会提示该安装包未签名，README 给出的操作是 More info → Run anyway 安装步骤。

从源码运行时，先安装 Node.js 22+，在仓库根目录执行：

cd desktop
npm install
npm run build
npm start

桌面应用随后打开，并在 http://127.0.0.1:47821 提供 API 源码运行步骤。

打开 Settings → API & agent，可以把生成的密钥粘贴到智能体配置中，也可以加入 MCP 地址走 OAuth：

{
  "mcpServers": {
    "muse4ai": { "url": "http://127.0.0.1:47821/mcp" }
  }
}

在应用内用 6 位数字确认码批准访问。若直接用密钥发 REST 请求：

curl -X POST http://127.0.0.1:47821/v1/jobs \
  -H "Authorization: Bearer msk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"video","prompt":"a coffee cup on an oak desk, warm morning light"}'

任务进入应用内队列，结果出现在本地媒体库 API 密钥示例。机器可读的接口定义位于 /v1/openapi.json。

使用约束

• 非官方自动化。 项目与 Meta 无关联，操作的是用户的 Muse 网页会话。网站改版可能导致失效，README 也提醒自动化行为未必符合 Meta 的服务条款 限制说明。
• 仅打包 Windows。 macOS 和 Linux 尚未打包或测试；核心代码被描述为不依赖 Windows。
• 安装包未签名。 安装版会触发 Windows 警告；源码运行方式不经过该分发路径。
• 本地存储。 结果、密钥和令牌都存在本机 %APPDATA%\MuseStudio；项目未描述云账号或遥测服务器。
• 许可证。 项目采用 MIT 许可证 许可证。

HotRepo 点评

Muse4AI 在 2026-11-04 进入 HotRepo 新项目榜，统计窗口从 2026-11-03 开始，记录到 198 个 Star 和 54 个 Fork；仓库处于观察首日，没有更长周期的趋势可判断。技术定位是本地桥接而非托管服务，MCP 端点、按范围授权的密钥和 OAuth 确认码都是明确的集成入口，安装包与源码两条路径也都有说明。更值得留意的是分发信任：主要安装路径是未签名的 Windows 安装包，而它与仓库源码构建之间的对应关系没有在材料中说明。

开发

在 desktop/ 下，npm test 运行测试，npm run typecheck 做严格 TypeScript 检查，npm run package:win 生成 Windows ZIP 和安装包输入 开发命令。