Voicestudio MCP Server

🚀 Kokoro MCP Server Development Environment Configuration Guide

This guide provides a step-by-step process for configuring the development environment of the Kokoro MCP server, including installing dependencies, setting up services, and addressing common issues.

📦 Installation

1. Install System Tools

sudo apt-get update && sudo apt-get install -y \
    cmake \
    build-essential \
    python3-dev \
    python3-pip \
    git \
    curl \
    jq

2. Install Python Packages

pip3 install --user -r requirements.txt

📦 MeCab Configuration

1. Download and Install MeCab:

   cd /usr/local
   sudo wget https://mecabDOWNLOAD_URL
   sudo tar zxvf mecabDOWNLOAD_FILENAME
   sudo ln -sf /usr/local/mecab/bin/mecab /usr/bin/mecab
   

2. Install the Japanese Dictionary for MeCab:

   cd /usr/local/lib
   sudo wget https://mecabDOWNLOAD_DICT_URL
   sudo tar zxvf mecabDOWNLOAD_DICT_FILENAME
   sudo ln -sf /usr/local/lib/mecab/dict /var/lib/mecab/dict
   

3. Configure MeCab Environment Variables:

   echo 'export MECABRC=/path/to/mecabrc' >> ~/.bashrc
   source ~/.bashrc
   

📦 PyOpenJTalk Installation

1. Clone the OpenJTalk Repository:

   git clone https://github.com/KyotoU-MediaComputing/openjtalk.git
   cd openjtalk
   mkdir build && cd build
   cmake ..
   make
   sudo make install
   

2. Install PyOpenJTalk:

   pip3 install --user pyopenjtalk
   

💻 Development Environment Startup

1. Start the MeCab Service:

   mecab -d /var/lib/mecab/dict -u your_mecab_user
   

2. Start the OpenJTalk Service:

   open_jtalk -i your_openjtalk_iname
   

❓ Common Issues and Solutions

1. MeCab-Related Errors

• MeCab Not Found: Check if MeCab is correctly installed and added to the PATH environment variable.

• Cannot Access the mecabrc File:

  find / -name mecabrc 2>/dev/null
  export MECABRC=/path/to/mecabrc
  sudo ln -sf /path/to/mecabrc /usr/local/etc/mecabrc
  

2. PyOpenJTalk Installation Issues

• Missing Dependencies: Ensure that all necessary system tools and libraries are installed.

🛠️ Code Quality Tools

1. Format Code with Black:

   black src/ tests/
   

2. Organize Import Statements:

   isort src/ tests/
   

3. Perform Static Checks:

   flake8 src/ tests/
   mypy src/
   

⚙️ Environment Variable Configuration

Adjust the following environment variables to customize the server behavior:

• OPENAI_API_KEY: OpenAI API key
• CLAUDE_API_KEY: Claude API key
• LOG_LEVEL: Log level (DEBUG, INFO, WARNING, ERROR)
• MOCK_TTS: Enable or disable mock mode (true/false)
• PORT: Server port (default: 8080)

🌟 Advanced Topics

1. Using Docker:

   • Build an Image:

     docker build -t kokoro-mcp-server .
     

   • Run a Container:

     docker run -it --rm KokoroMCP/server:latest
     

2. Configuration File Management:

   • Create a config.yml file to customize server settings.

3. Logging and Monitoring:

   • Configure the output path and format of log files.

4. Performance Tuning:

   • Adjust the number of Gunicorn workers and timeout settings according to your needs.

By following the above steps, you have successfully configured the development environment for the Kokoro MCP server. Happy coding!