Integrations
Enables configuration of the server through environment variables, allowing customization of API endpoints and speaker settings
Used for cloning the repository and managing the source code
Hosts the repository and provides issue tracking for bug reports and feature requests
AivisSpeech MCP 服务器
AivisSpeech 的模型上下文协议 (MCP) 服务器实现。该服务器与AivisSpeech引擎配合,提供语音合成接口。通过MCP协议,AivisSpeech的语音合成能力可以轻松被AI助手等应用程序使用。
概述
AivisSpeech MCP 服务器提供以下功能:
- 符合 MCP 协议的 API 端点
- 与 AivisSpeech Engine 合作的高质量语音合成
- 使用 TypeScript 进行类型安全设计
- 易于配置且高度可扩展的架构
先决条件
- Node.js 18.x 或更高版本
- npm 9.x 或更高版本
- AivisSpeech 引擎(需要单独安装)
安装
环境设置
在您的.env
文件中,设置以下内容:
光标 MCP 设置
在.cursor/mcp.json
文件中,配置以下内容:
将/path/to/aivis-speech-mcp/dist/index.js
替换为您的项目路径。对于 Windows,请转义反斜杠或使用正斜杠。例如: "C:/Users/username/path/to/aivis-speech-mcp/dist/index.js"
如何使用
开发模式
在开发过程中,您可以使用以下命令通过热重载启动服务器:
建造
要构建生产环境,请运行以下命令:
生产模式
构建完成后,使用以下命令以生产模式启动服务器:
测试
要运行测试,请使用以下命令:
建筑学
AivisSpeech MCP 服务器由以下组件组成:
- MCP服务:提供符合模型上下文协议的服务器,处理来自客户端的请求。
- AivisSpeech 服务:与 AivisSpeech 引擎 API 通信并执行语音合成。
API 规范
提供符合 MCP 协议的 API 端点。主要特点包括:
- 语音合成(从文本生成语音)
- 获取演讲者信息
- 音频风格设置
详细API规范请参考AivisSpeech引擎API规范。
与 MCP 协议集成
该服务器实现了模型上下文协议(MCP),可以被AI助手等应用程序无缝使用。有关 MCP 协议的更多信息,请参阅MCP 官方文档。
故障排除
常见问题及解决方案:
- 无法连接到 AivisSpeech 引擎:检查
.env
文件中的AIVIS_SPEECH_API_URL
是否设置正确 - 没有声音:检查系统的音频设置并确保选择了正确的音频设备
- 未找到扬声器 ID :确保 AivisSpeech 引擎正常运行并检查可用的扬声器 ID。
贡献
请通过我们的 GitHub 问题跟踪器报告错误或功能请求。也欢迎拉取请求。
执照
致谢
This server cannot be installed
模型上下文协议服务器,使AI助手能够通过标准化API接口利用AivisSpeech Engine的高质量语音合成功能。