mcpField
V
viberadio-fm

viberadio-fm

本地服务
github.com/pooriaarab媒体与设计12 周前更新
代码仓库

关于 viberadio-fm

viberadio-fm 是面向开发者的开源文本转语音命令行工具和库，可将文本或编码会话事件转为本地语音。它支持生成事件回顾脚本，并提供 MCP 工具；不监视会话，也不提供托管音频服务。

主要功能

  1. 01通过系统工具进行本地语音合成
  2. 02支持独白和播客式回顾
  3. 03根据事件数组生成回顾
  4. 04提供命令行工具和 JavaScript 库
  5. 05支持注入旁白器依赖

适用场景

  1. 01朗读构建状态
  2. 02在本地朗读提供的文本
  3. 03回顾编码会话中的里程碑事件

MCP 相关

通过 `viberadio mcp` 启动的 MCP 服务提供 `narrate` 和 `recap` 工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "pooriaarab-viberadio-fm": {
      "command": "npx",
      "args": [
        "-y",
        "viberadio-fm"
      ]
    }
  }
}
启动命令npx -y viberadio-fm

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmviberadio-fm0.2.3

工具

2

收录的工具列表 · 更新于 2 周前

参数类型必填说明
textstring是要朗读的文本。
styleenum否为将来的按风格选择语音预留。monologue | podcast

详细介绍

VibeRadio

npm version Downloads/month MIT license

网站 · 安装 · 库和 MCP

VibeRadio 是一个开源的文本转语音命令行工具和库，可将提供的文本或编码会话事件转换为本地语音叙述，供开发者使用。

安装

npm install -g viberadio-fm
viberadio say "Build passed"

需要 Node.js 18 或更高版本，以及系统语音工具：macOS 上的 say、Linux 上的 espeak 或 Linux 上的 spd-say。 成功时，你会听到“Build passed”，并看到一条本地提供程序状态消息。 如果语音功能不可用，命令行工具会打印文本和设置警告，然后成功退出。 无需 API 密钥或环境变量。命令行工具不会加载 .env 文件。

回顾会话

printf '[{"kind":"tests-pass","count":12}]' | viberadio recap
printf '[{"kind":"tests-pass","count":12}]' | viberadio recap --style podcast

第二条命令会将脚本改为带主机标签的对话。两种风格都使用同一个系统语音。 你也可以传入 JSON 数组文件：viberadio recap session.json --mode podcast。

功能与限制

  • **本地语音：**默认音频路径会禁用网络出口，并使用来自 @pooriaarab/vibe-core 的系统语音运行器。
  • **回顾脚本：**格式化里程碑事件；支持 monologue 或 podcast 风格，以及 summary 或 podcast 模式。
  • **库桥接：**库的 recap() 成功执行后，会尽力追加一条 vibenotifications 事件；命令行工具和 MCP 回顾会直接调用语音叙述。
  • 两个 MCP 工具：narrate 可朗读文本；recap 可生成并朗读事件回顾。
text / event array -> narration script -> system speech tool -> audio

没有自动的 Agent 会话监视器或后台 start 命令。 本软件包不提供响应式音乐、云端语音、不同的播客语音、录音、可视化工具或菜单栏应用。 本软件包不包含 Claude Code、Codex 或 Gemini 适配器；请从你的工作流传入文本或事件。 源码检查确认，共享运行器支持三种系统工具选择。此重写未验证实际音频输出。

库和 MCP

import { buildRecapScript, narrate, recap } from 'viberadio-fm';

console.log(buildRecapScript([{ kind: 'tests-pass', count: 12 }]));
await narrate('Build passed');
await recap([{ kind: 'task-done', message: 'Fixed login' }]);

buildRecapScript() 是纯函数，无需语音工具即可运行。音频无法运行时，narrate() 会抛出 TtsUnavailableError。 createNarrator() 提供依赖注入；软件包附带 TypeScript 声明文件。 使用以下配置 MCP 客户端：

{"mcpServers":{"viberadio":{"command":"viberadio","args":["mcp"]}}}

命令行命令：say、recap、mcp、help/--help/-h 和 --version/-v。 say 命令接受 --style/-s；recap 还接受 --mode/-m，并支持从文件或标准输入读取。 设置 VIBERADIO_DEBUG=1 可查看语音故障详情。

状态与链接

版本 0.2.4 尚未达到 1.0。接口可能会变更；本软件包不提供托管音频服务。 仓库中的交互式原型和发布视频展示的是产品方向，而非已发布的功能。 报告问题 · Vibe Suite · MIT 许可证

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。