使用说明
SDLC进度公告的文本转语音MCP服务器
模型上下文协议(MCP)服务器,使用AWS Polly在软件开发生命周期工作流期间提供实时音频反馈。
概述
此TTS MCP服务器与CLI代理编排器集成,在整个SDLC工作流程的关键里程碑上宣布进度,提供音频反馈,而不需要持续的屏幕监控。
特性
- 实时进度公告:每个SDLC阶段的音频通知
- AWS Polly集成:高质量的神经文本转语音
- 与跨平台支持:适用于macOS、Linux(Windows通过WSL)
- 可配置的:通过环境变量启用/禁用
- 多种声音:支持不同的AWS Polly语音
先决条件
- Python 3.8+
uv已安装包管理器(安装指南)- 具有Polly访问权限的AWS帐户
- 已配置AWS凭据(
aws configure) - IAM权限
polly:SynthesizeSpeech - 音频输出设备
安装
TTS MCP服务器由自动安装和管理 uv 安装监督代理时。无需手动安装或虚拟环境设置。
使用绝对路径更新supervisor.md
编辑 supervisor.md 并将路径替换为绝对路径:
tts-mcp-server:
type: stdio
command: uv
args:
- "run"
- "python"
- "/Users/yourusername/echo-reinvent/echo-architect/tts-mcp-server/server.py"
安装监控代理
cao install ../cli_agent_orchestrator/agent_store/supervisor.md
用法
TTS启动主管
cao launch --agents supervisor
给它一个任务
"Create a social media app like Facebook"
您将听到以下公告:
- 🔊 “启动新项目社交媒体应用程序”
- 🔊 “为您的项目创建规范”
- 🔊 “规范已完成。开始并行开发阶段”
- 🔊 “使用CDK和React构建AWS解决方案”
- 🔊 “生成体系结构图”
- 🔊 “计算AWS成本估算”
- 🔊 “在Jira中创建用户故事”
- 🔊 “所有并行任务均已完成”
- 🔊 “将工件发布到GitHub存储库”
- 🔊 “项目已成功完成。总时间:X分钟”
配置
启用/禁用TTS
# Enable (default)
export ENABLE_TTS=true
# Disable
export ENABLE_TTS=false
可用声音
- 乔安娜 (美国女性)-违约,总体进展
- 马太 (美国男性)-错误通知
- 萨利 (美国女性)-完成信息
故障排除
无音频输出
检查AWS凭据:
aws sts get-caller-identity
验证Polly的访问权限:
aws polly describe-voices --language-code en-US
测试音频系统:
# macOS
afplay /System/Library/Sounds/Ping.aiff
# Linux
speaker-test -t wav -c 2
TTS不工作
检查环境:
echo $ENABLE_TTS # Should be 'true' or empty
重新安装监控器:
cao install ../cli_agent_orchestrator/agent_store/supervisor.md
权限错误
将Polly权限添加到IAM用户/角色:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "polly:SynthesizeSpeech",
"Resource": "*"
}
]
}
找不到模块错误
验证supervisor.md中的绝对路径是否正确:
cat ../cli_agent_orchestrator/agent_store/supervisor.md | grep server.py
重新安装监督代理:
cao install ../cli_agent_orchestrator/agent_store/supervisor.md
文件
tts-mcp-server/
├── server.py # FastMCP TTS server
├── pyproject.toml # Python project configuration for uv
├── requirements.txt # Python dependencies
├── .gitignore # Git exclusions
└── README.md # This file
重要提示
- ✅ 无需虚拟环境 -
uv自动管理依赖关系 - ✅ 使用绝对路径 -用server.py的完整路径更新supervisor.md
- ✅ 已自动安装依赖项 -
uv主管启动时处理所有事务