AivisSpeech MCP Server

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 引擎(需要单独安装)

安装

# リポジトリをクローン 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

光标 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服务:提供符合模型上下文协议的服务器,处理来自客户端的请求。
  • AivisSpeech 服务:与 AivisSpeech 引擎 API 通信并执行语音合成。

API 规范

提供符合 MCP 协议的 API 端点。主要特点包括:

  • 语音合成(从文本生成语音)
  • 获取演讲者信息
  • 音频风格设置

详细API规范请参考AivisSpeech引擎API规范

与 MCP 协议集成

该服务器实现了模型上下文协议(MCP),可以被AI助手等应用程序无缝使用。有关 MCP 协议的更多信息,请参阅MCP 官方文档

故障排除

常见问题及解决方案:

  • 无法连接到 AivisSpeech 引擎:检查.env文件中的AIVIS_SPEECH_API_URL是否设置正确
  • 没有声音:检查系统的音频设置并确保选择了正确的音频设备
  • 未找到扬声器 ID :确保 AivisSpeech 引擎正常运行并检查可用的扬声器 ID。

贡献

请通过我们的 GitHub 问题跟踪器报告错误或功能请求。也欢迎拉取请求。

执照

麻省理工学院

致谢

-
security - not tested
F
license - not found
-
quality - not tested

模型上下文协议服务器,使AI助手能够通过标准化API接口利用AivisSpeech Engine的高质量语音合成功能。

  1. 概要
    1. 必要条件
      1. インストール
        1. 環境設定
          1. Cursor MCP設定
            1. 使い方
              1. 開発モード
              2. ビルド
              3. 本番モード
              4. テスト
            2. アーキテクチャ
              1. API仕様
                1. MCPプロトコルとの連携
                  1. トラブルシューティング
                    1. 貢献
                      1. ライセンス
                        1. 謝辞
                          ID: f2aqlus2ip