Kokoro MCP Server 開発環境セットアップガイド

基本能力

产品定位

Kokoro MCP Server 是一个语音合成和处理服务器，支持多种开发模式和调试功能。

核心功能

1. 语音合成：支持Kokoro音声合成引擎，并提供模拟模式用于开发环境。
2. 开发模式：支持开发模式，自动加载变更并启用调试日志。
3. 测试环境：包含自动测试套件，支持测试用客户端。
4. Docker支持：提供Docker容器化部署，支持多架构构建。
5. 代码质量工具：集成Black、isort、flake8和mypy等代码质量工具。

适用场景

1. 语音合成开发：用于开发和测试语音合成应用。
2. 自动化测试：支持自动化测试和持续集成。
3. 多平台部署：支持Docker容器化部署，适用于多种平台。

工具列表

1. uv：包管理器，用于安装依赖和管理虚拟环境。
2. Docker：容器化工具，用于构建和运行容器。
3. Black：代码格式化工具。
4. isort：导入排序工具。
5. flake8：代码检查工具。
6. mypy：静态类型检查工具。

常见问题解答

1. MeCab相关错误：检查MeCab配置文件路径或重新安装MeCab。
2. fugashi和unidic错误：卸载并重新安装相关包。
3. PyTorch错误：重新安装PyTorch。
4. Docker问题：使用无缓存构建或检查容器日志。
5. PyOpenJTalk问题：设置环境变量后重新安装。

使用教程

使用依赖

1. Python 3.10及以上
2. uv包管理器
3. Git
4. Docker和Docker Compose
5. Kokoro音声合成引擎（实模式使用）

安装教程

1. 克隆仓库 bash git clone https://github.com/yourusername/Kokoro-MCP-Server.git cd Kokoro-MCP-Server
2. 安装uv和创建虚拟环境 bash curl -sSf https://astral.sh/uv/install.sh | sh uv venv source .venv/bin/activate
3. 安装依赖包 bash uv pip install -r requirements.txt uv pip install -r requirements-dev.txt
4. 安装PyOpenJTalk bash CMAKE_POLICY_VERSION_MINIMUM=3.5 uv pip install pyopenjtalk

调试方式

1. 开发模式运行 bash MOCK_TTS=true python src/main.py --dev
2. 启用调试日志 bash python src/main.py --log-level debug
3. 使用Python Debugger python import pdb; pdb.set_trace()
4. 启用请求/响应日志 bash python src/main.py --log-level debug --log-requests

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。