Kokoro MCP Server

🚀 Kokoro 脳波サーバー開発環境構成ガイド

このガイドは、Kokoro脳波サーバーの開発環境を構成する手順を提供します。開発環境を設定することで、円滑に開発作業を行うことができます。

🚀 クイックスタート

以下の手順に従って、Kokoro脳波サーバーの開発環境を構築しましょう。

✨ 主な機能

• 開発環境の構築手順を提供します。
• 各種依存関係のインストール方法を案内します。
• サーバーの起動方法や設定ファイルの例を示します。
• 開発ツールやコードチェックの方法を紹介します。
• よくある問題とその解決策を提供します。
• MCP開発のベストプラクティスを共有します。
• 環境変数の設定方法を説明します。
• Docker関連の問題のトラブルシューティングを行います。

📦 インストール

環境要件

• オペレーティングシステム：Linux（推奨）/ macOS / Windows
• Pythonバージョン：3.7+
• Node.jsバージョン：12+

依存関係のインストール

プロジェクトのクローン

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

Python依存関係のインストール

pip install -r requirements.txt

Node.js依存関係のインストール（フロントエンド開発のみ）

npm install

💻 使用例

基本的な使用法

サーバーの起動

# サーバーを起動する
python src/main.py

# または指定の設定ファイルを使用する
python src/main.py --config config.yaml

高度な使用法

設定ファイルの例（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']

📚 ドキュメント

開発ツール

Blackコードフォーマッター

black src/ tests/

isortインポート整理

isort src/ tests/

flake8コードチェック

flake8 src/ tests/

mypy静的型チェック

mypy src/

よくある問題と解決策

1. MeCab関連のエラー

• MeCabがインストールされているか確認する：

  which mecab
  

• 設定ファイルを探す：

  find / -name mecabrc 2>/dev/null
  

• 環境変数を設定する：

  export MECABRC=/path/to/mecabrc
  

2. fugashiとunidic関連のエラー

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

MCP開発のベストプラクティス

1. ツールの定義を明確にする：MCPツールのパラメータと戻り値を明確に定義します。
2. エラー処理を完備する：すべてのMCPリクエストに適切なエラー処理を確保します。
3. テスト駆動開発を行う：新機能を追加する前にテストケースを作成します。
4. ドキュメントを適切に記述する：すべてのAPIとツールに詳細なドキュメントを提供します。

環境変数の設定

• OPENAI_API_KEY：OpenAI APIキー
• CLAUDE_API_KEY：Claude APIキー
• LOG_LEVEL：ログレベル（DEBUG, INFO, WARNING, ERROR）
• MOCK_TTS：モックモードを有効にする（true/false）
• PORT：サーバーのポート（デフォルト：8080）

付録

Docker関連の問題のトラブルシューティング

1. ビルド失敗

make build-no-cache

2. コンテナの起動失敗

docker logs kokoro-mcp-server

以上の手順に従って、Kokoro脳波サーバーの開発環境を構成することができます。開発を楽しんでください！