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 问题跟踪器报告错误或功能请求。也欢迎拉取请求。

执照

麻省理工学院

致谢

• Aivis语音引擎团队

• 模型上下文协议开发者