AivisSpeech MCP 服务器

这是 AivisSpeech 的 Model Context Protocol (MCP) 服务器的实现。该服务器与 AivisSpeech Engine 协同工作，为语音合成提供接口。通过 MCP 协议，可以轻松地从 AI 助手等应用程序中使用 AivisSpeech 的语音合成功能。

概要

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

• 符合 MCP 协议的 API 端点
• 通过与 AivisSpeech Engine 协同实现高质量的语音合成
• 使用 TypeScript 实现类型安全的設計
• 简单的配置和高度可扩展的架构

必要条件

• Node.js 18.x 或更高版本
• npm 9.x 或更高版本
• AivisSpeech Engine（需要单独安装）

安装

# 克隆仓库
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:10101  # AivisSpeech Engine 的 API 端点

# Speaker Configuration
AIVIS_SPEECH_SPEAKER_ID=888753760  # 默认的说话人 ID

Cursor MCP 设置

在 .cursor/mcp.json 文件中进行以下设置：

{
  "mcpServers": {
    "AivisSpeech-MCP": {
      "command": "node",
      "args": ["/path/to/aivis-speech-mcp/dist/index.js"]
    }
  }
}

将 /path/to/aivis-speech-mcp/dist/index.js 替换为实际的项目路径。 如果是 Windows，请转义反斜杠或使用正斜杠。 例如: "C:/Users/username/path/to/aivis-speech-mcp/dist/index.js"

使い方 (使用方法)

開発モード (开发模式)

在开发过程中，可以使用以下命令以热重载功能启动服务器：

npm run dev

ビルド (构建)

如果要为生产环境构建，请执行以下命令：

npm run build

本番モード (生产模式)

构建完成后，可以使用以下命令以生产模式启动服务器：

npm start

テスト (测试)

要运行测试，请使用以下命令：

npm test

アーキテクチャ (架构)

AivisSpeech MCP 服务器由以下组件构成：

• MCP 服务: 提供符合 Model Context Protocol 的服务器，并处理来自客户端的请求
• AivisSpeech 服务: 与 AivisSpeech Engine 的 API 通信，并执行语音合成

API仕様 (API 规范)

提供符合 MCP 协议的 API 端点。主要功能如下：

• 语音合成（从文本生成语音）
• 获取说话人信息
• 设置语音风格

有关详细的 API 规范，请参阅 AivisSpeech Engine API 规范。

MCPプロトコルとの連携 (与 MCP 协议的协作)

该服务器实现了 Model Context Protocol (MCP)，可以从 AI 助手等应用程序无缝使用。有关 MCP 协议的更多信息，请参阅 MCP 官方文档。

トラブルシューティング (故障排除)

常见问题和解决方案：

• 无法连接到 AivisSpeech Engine: 检查 .env 文件中的 AIVIS_SPEECH_API_URL 是否已正确设置
• 无法播放语音: 检查系统的音频设置，并确认已选择合适的音频设备
• 找不到说话人 ID: 检查 AivisSpeech Engine 是否已正确启动，并确认可用的说话人 ID

貢献 (贡献)

错误报告和功能请求请通过 GitHub 的 Issue 跟踪器提交。欢迎提交 Pull Request。

ライセンス (许可证)

MIT

謝辞 (鸣谢)

• AivisSpeech Engine 团队
• Model Context Protocol 的开发者