Miragea AI配音 · 文字转语音 · 声音克隆 · 字幕生成 Agent Skills & MCP Servers

AI Voiceover · Text to Speech (TTS) · Voice Cloning · Subtitle Generator — open-source Agent Skills (SKILL.md) powered by the official Miragea API.

开源 Agent 技能合集（SKILL.md 格式）：一份文字稿，一条命令生成 AI配音 WAV + 带时间轴的 SRT 字幕 + 逐句时间 manifest.json。音色可用 Miragea 账号里已有的角色，也可以用一段参考音频做声音克隆；已有的视频或音频也能自动识别生成 SRT / TXT / JSON 字幕。所有技能都随附 Miragea 官方客户端 miragea_audio.py，本地只需 Python 3.9+ 标准库，无需显卡。适用于 Claude Code、Codex、OpenClaw、Cursor、WorkBuddy 等任何能运行 Python 的 Agent。

Script in, multi-voice voiceover WAV + timed SRT subtitles + per-line timing JSON out. Use saved voices from your Miragea account or clone a voice from a reference clip, and turn existing video/audio into SRT, TXT or JSON subtitles. Every skill ships the official Miragea client (miragea_audio.py) and needs only the Python 3.9+ standard library — no GPU. Works with Claude Code, Codex, OpenClaw, Cursor, WorkBuddy and any agent that can run Python.

技能列表 · Skills

每个技能文件夹都包含 SKILL.md（完整用法、写稿方法、FAQ）、README.md、examples/ 示例稿和 scripts/（voiceover.py 拼接层 + miragea_audio.py 官方客户端）。

Each folder contains SKILL.md (full usage, scripting guide, FAQ), README.md, an example script under examples/, and scripts/ (voiceover.py + the official miragea_audio.py client).

Related MCP server: suggest-skills

安装 · Install

npx skills add yanghhu/miragea-voiceover-skills

或者把 skills/ 下任意文件夹复制到 Agent 的 skills 目录（如 ~/.claude/skills/、~/.codex/skills/）。

Or copy any folder under skills/ into your agent's skills directory (e.g. ~/.claude/skills/, ~/.codex/skills/).

git clone https://github.com/yanghhu/miragea-voiceover-skills.git
cp -r miragea-voiceover-skills/skills/koubo-ai-voiceover ~/.claude/skills/

API Key

在 Miragea 工作台生成 API Key：https://miragea.ai/workspace/api，然后设置环境变量 MIRAGEA_API_KEY。没有 Key 时可以先加 --dry-run 离线试跑（生成静音占位音频，不调用接口）。

Create an API key at https://miragea.ai/workspace/api and export it as MIRAGEA_API_KEY. Without a key, add --dry-run to try everything offline (silent placeholder audio, no API call).

export MIRAGEA_API_KEY=your_key

快速开始 · Quick start

cd skills/miragea-video-voiceover

# 离线检查环境 · offline environment check
python3 scripts/voiceover.py check

# 离线试跑，无需 Key · offline dry run, no key needed
python3 scripts/voiceover.py script examples/movie-recap.md -o out --preset jieshuo --dry-run

# 正式生成：out/voiceover.wav + voiceover.srt + manifest.json
python3 scripts/voiceover.py script examples/movie-recap.md -o out --preset jieshuo

# 查看账号已有角色 · list saved voices in your account
python3 scripts/miragea_audio.py actors --limit 20

# 文字转语音单句 · single-line text to speech
python3 scripts/miragea_audio.py generate --text '你好，欢迎回来。' --actor-id ACTOR_ID --wait --output hello.mp3

# 视频自动加字幕 · video to SRT subtitles
python3 scripts/miragea_audio.py recognize --file video.mp4 --wait --output video.srt

生成模式、语气标签、单句字数上限和计费以 python3 scripts/miragea_audio.py capabilities 的实时返回为准。

Generation modes, emotion tags, per-line limits and billing are whatever python3 scripts/miragea_audio.py capabilities returns live.

MCP 服务器 · MCP Servers（AI配音 MCP / 文字转语音 MCP / 播客生成 MCP / 字幕生成 MCP）

除了技能，本仓库还提供两个 MCP 服务器（Model Context Protocol，stdio，Python 3.9+ 标准库）：在 Claude Desktop、Cursor、WorkBuddy、Cherry Studio 等任何 MCP 客户端里直接调用 文字转语音、声音克隆、多角色对话配音（双人播客 / 多人视频配音，一次输出 WAV + SRT + 逐句时间轴）和音视频字幕生成。

Besides the skills, the repo ships two MCP servers (stdio, Python 3.9+ stdlib) for any MCP client: text to speech, voice cloning, multi-speaker dialogue voiceover (two-host podcast generator, multi-character dubbing → WAV + SRT + per-line timings) and audio/video to SRT subtitles.

工具 Tools：get_capabilities · list_voices · text_to_speech · dialogue_voiceover · generate_subtitles · get_task；提示词 Prompts：two_host_podcast · multi_character_dubbing。

{
  "mcpServers": {
    "miragea-voiceover": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/yanghhu/miragea-voiceover-skills#subdirectory=mcp/miragea-voiceover-mcp", "miragea-voiceover-mcp"],
      "env": { "MIRAGEA_API_KEY": "your-api-key" }
    }
  }
}

• 国内版把 miragea 换成 quips、环境变量换成 QUIPS_API_KEY。离线试跑：python3 mcp/<名称>/<包名>/server.py --self-test（无需 Key，不联网）。

• Claude Desktop 扩展包（.mcpb）在 mcp/dist/；WorkBuddy / CodeBuddy / Claude Code 可把本仓库添加为插件市场：/plugin marketplace add yanghhu/miragea-voiceover-skills，安装 quips-voiceover-mcp 或 miragea-voiceover-mcp 插件。

• WorkBuddy 手动配置：写入 ~/.workbuddy/mcp.json（格式同上），在连接器管理里点“信任”。

合规 · Responsible use

声音克隆只能使用本人或已获得明确授权的声音。请遵守所在平台关于 AI 生成内容的标注要求。

Only clone voices you own or have explicit permission to use, and follow your platform's rules on labeling AI-generated content.

链接 · Links

• Miragea: https://miragea.ai

• API Key: https://miragea.ai/workspace/api

• llms.txt: llms.txt

License

MIT © 2026 Miragea