Kokoro MCP Server

🚀 Kokoro Brainwave Server Development Environment Configuration Guide

This guide provides a detailed introduction to the development environment configuration of the Kokoro Brainwave Server, helping you quickly set up the development environment and start development.

🚀 Quick Start

Environment Requirements

• Operating System: Linux (Recommended) / macOS / Windows
• Python Version: 3.7+
• Node.js Version: 12+

Installation Steps

Project Cloning

git clone https://github.com/your-repository/kokoro-mcp-server.git
cd kokoro-mcp-server

Installing Python Dependencies

pip install -r requirements.txt

Installing Node.js Dependencies (For Front - end Development Only)

npm install

Starting the Server

# Start the server
python src/main.py

# Or use a specified configuration file
python src/main.py --config config.yaml

✨ Features

Project Structure

kokoro-mcp-server/
├── src/          # Back - end service code
│   ├── main.py        # Main program entry
│   └── modules/      # Core functional modules
├── public/        # Front - end resource files (if needed)
└── README.md       # Project documentation

Configuration File Example (config.yaml)

server:
  host: '0.0.0.0'
  port: 8080
logging:
  level: DEBUG
  file: ./logs/server.log
  max_size: 1024
  backup_count: 3
mcp:
  enabled_plugins: ['plugin1', 'plugin2']

💻 Usage Examples

Basic Usage

The following commands are used to start the server:

# Start the server
python src/main.py

# Or use a specified configuration file
python src/main.py --config config.yaml

Advanced Usage

The following commands are used for code formatting, import sorting, code checking, and static type checking:

# Black code formatting
black src/ tests/

# isort import sorting
isort src/ tests/

# flake8 code checking
flake8 src/ tests/

# mypy static type checking
mypy src/

📚 Documentation

Development Tools

Black Code Formatting

black src/ tests/

isort Import Sorting

isort src/ tests/

flake8 Code Checking

flake8 src/ tests/

mypy Static Type Checking

mypy src/

Best Practices for MCP Development

1. Clear Tool Definition: Clearly define the parameters and return values of MCP tools.
2. Complete Error Handling: Ensure that all MCP requests have appropriate error handling.
3. Test - Driven Development: Create test cases before adding new features.
4. Document Writing Specification: Provide detailed documentation for all APIs and tools.

Environment Variable Configuration

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

Common Issues and Solutions

1. MeCab - Related Errors

• Check if MeCab is installed:

  which mecab
  

• Find the configuration file:

  find / -name mecabrc 2>/dev/null
  

• Set the environment variable:

  export MECABRC=/path/to/mecabrc
  

2. fugashi and unidic - Related Errors

uv pip uninstall fugashi ipadic unidic-lite
uv pip install fugashi[unidic] unidic-lite ipadic

Appendix: Docker - Related Issue Troubleshooting

1. Build Failure

make build-no-cache

2. Container Startup Failure

docker logs kokoro-mcp-server

Through the above steps, the development environment for the Kokoro Brainwave Server has been configured. Happy coding!