SFX MCP Server

基本能力

产品定位

SFX MCP Server 是一个音效生成服务，通过 ElevenLabs API 实现文本到音效的转换。

核心功能

• 提供 generate_sfx 工具，根据文本提示生成音效。
• 支持自定义音效时长、提示影响力、输出目录和文件名。
• 生成音效并返回 MP3 文件的绝对路径。

适用场景

• 游戏开发中的音效生成。
• 多媒体内容创作中的音效需求。
• 自动化音效生成流程。

工具列表

• generate_sfx:
• 描述：根据文本提示生成音效并返回 MP3 文件路径。
• 参数：
  • text（必填）：音效描述文本。
  • duration_seconds（可选）：音效时长（秒）。
  • prompt_influence（可选）：提示影响力（0.0-1.0）。
  • output_directory（可选）：输出目录。
  • output_filename（可选）：输出文件名。
• 输出：生成的 MP3 文件绝对路径。

常见问题解答

• Q: 如何获取 ElevenLabs API Key？ A: 需要在 ElevenLabs 官网注册并获取 API Key。
• Q: 如何手动测试服务器启动？ A: 在项目目录下运行 hatch run serve_mcp。

使用教程

使用依赖

• Python 3.8+
• Hatch（Python 项目管理工具）
• ElevenLabs API Key

安装教程

1. 配置 API Key: 在项目根目录创建 .env 文件，内容如下： env ELEVENLABS_API_KEY="your_actual_elevenlabs_api_key"
2. Hatch 环境设置: MCP 客户端（如 Cline）会自动创建虚拟环境并安装依赖。如需手动测试，可运行： bash hatch run serve_mcp

调试方式

• 确保 .env 文件中的 API Key 正确。
• 检查 Hatch 虚拟环境是否正确创建。
• 运行 hatch run serve_mcp 查看服务器启动日志。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。