AivisSpeech MCP 服务器

AivisSpeech 音声合成用の Model Context Protocol (MCP) 服务器的实现。此服务器与 AivisSpeech 引擎联动，提供音声合成的接口。通过 MCP 协议，AI 助手等应用程序可以轻松使用 AivisSpeech 的音声合成功能。

概要

AivisSpeech MCP 服务器 提供以下功能：

• 符合MCP协议的API端点
• 高品质音声合成（通过AivisSpeech 引擎）
• TypeScript的类型安全设计
• 简单的设置和高扩展性架构

必要条件

• Node.js 18.x以上
• npm 9.x以上
• AivisSpeech 引擎（需另行安装）

安装

# リポジトリをクローン
git clone https://github.com/kentaro/aivis-speech-mcp.git
cd aivis-speech-mcp

# 依存関係のインストール
npm install

# ビルド
npm run build

# 環境変数の設定
cp .env.sample .env
# .envファイルを編集して、必要な設定を行ってください

# Cursor MCPの設定
cp .cursor/mcp.json.sample .cursor/mcp.json
# mcp.jsonファイル内の"/path/to/aivis-speech-mcp/dist/index.js"を
# 実際のプロジェクトパスに書き換えてください
# 例: "C:/Users/username/path/to/aivis-speech-mcp/dist/index.js"

環境設定

.envファイルで以下の設定を行います：

# AivisSpeech API Configuration
AIVIS_SPEECH_API_URL=http://localhost:10086  # 示例地址，需根据实际情况修改
AIVIS_SPEECH_API_KEY=your_api_key_here      # 替换为实际的API密钥

# 其他配置（如有）
SAMPLE_TEXT=hello                            # 示例文本

使用方法

基本使用步骤：

1. 安装依赖：运行 npm install 安装所需模块。
2. 环境配置：编辑 .env 文件，填写正确的 API 地址和密钥。
3. 构建项目：运行 npm run build 进行构建。
4. 启动服务：运行 npm start 启动服务器。

示例命令：

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start

架构

• 前端：负责接收用户请求和展示结果。
• 后端：处理业务逻辑，与 AivisSpeech 引擎通信。
• 引擎：提供音声合成服务。

API 规格

请求格式：

{
  "text": "hello world",
  "speaker_id": "1",
  "format": "wav"
}

响应格式：

{
  "audio_url": "http://example.com/audio.wav",
  "duration": 3.5
}

MCP 协议连携

通过 MCP 协议，实现与 AI 助手的无缝对接。具体步骤如下：

1. 注册服务：在 MCP 中心注册音声合成服务。
2. 配置参数：设置相关参数（如音调、速度等）。
3. 处理请求：接收并处理来自 MCP 的合成请求。

故障排除

常见问题及解决方法：

• 无法连接到 AivisSpeech 引擎：

  • 检查 .env 文件中的 AIVIS_SPEECH_API_URL 是否正确。
  • 确保引擎已启动且网络畅通。

• 音声未播放：

  • 检查系统音声设置，确保正确的音频设备已选择。
  • 确保生成的音频文件路径和权限正确。

• speaker_id 无效：

  • 确认 AivisSpeech 引擎中存在该 speaker_id。
  • 参考引擎文档获取可用的 speaker ID 列表。

贡献

欢迎通过 GitHub 的 Issue Tracker 提交问题或功能请求。我们也欢迎 Pull Request！

许可证

MIT

致谢

• AivisSpeech 引擎团队
• Model Context Protocol 开发者