Codealive

🚀 CodeAlive MCP サーバー構成ガイド

CodeAlive MCP サーバーは、様々な AI クライアントと統合するためのミドルウェアツールです。このドキュメントでは、Claude Desktop、Cursor、VS Code の Continue/Copilot プラグインなど、さまざまな AI クライアントをサポートするための MCP サーバーの構成方法を説明します。

🚀 クイックスタート

仮想環境のアクティブ化

MCP サーバーを実行する前に、Python 仮想環境をアクティブ化してください。

source venv/bin/activate  # macOS/Linux ユーザー向け
# または Windows ユーザーの場合は、PowerShell でプロジェクトディレクトリに移動して以下を実行します。
# .\venv\Scripts\activate

MCP サーバーの起動

仮想環境で CODEALIVE_API_KEY 環境変数を設定し（実際の API キーに置き換えてください）、MCP サーバーを起動します。

export CODEALIVE_API_KEY="your_api_key_here"
python src/codealive_mcp_server.py --debug

✨ クライアント構成

Claude Desktop の構成

1. Claude Desktop の設定画面を開きます。
2. 「MCP」または「拡張機能」セクションに移動し、新しい MCP サーバーを追加します。
   • 名前: codealive
   • タイプ: CodeAliveMcpProvider
3. 以下の構成パラメータを入力します。

{
  "command": "path/to/venv/bin/python",
  "args": [
    "src/codealive_mcp_server.py",
    "--debug"
  ],
  "env": {
    "CODEALIVE_API_KEY": "your_api_key_here"
  }
}

Cursor の構成

1. Cursor の設定を開きます。
2. 「MCP」セクションに移動し、新しいサーバー構成を追加します。
   • 名前: codealive
   • パス: Python 実行ファイルへのパス（例: /path/to/venv/bin/python）を指定します。

VS Code の Continue/Copilot プラグイン

1. VS Code の設定を開きます。
2. 「Continue」または「GitHub Copilot」の構成画面を検索して開きます。
3. MCP サーバー構成を追加します。

{
  "mcp.servers": [
    {
      "name": "codealive",
      "type": "CodeAliveMcpProvider",
      "command": "path/to/venv/bin/python",
      "args": ["src/codealive_mcp_server.py", "--debug"],
      "env": {
        "CODEALIVE_API_KEY": "your_api_key_here"
      }
    }
  ]
}

🔧 トラブルシューティング

デバッグログの有効化

クライアント構成に --debug フラグを追加して詳細なログ記録を有効にします。

{
  "args": [
    "src/codealive_mcp_server.py",
    "--debug"
  ]
}

MCP サーバー出力の確認

MCP サーバーコマンドを直接実行して、エラーメッセージがないことを確認します。以下の点に注意してください。

• CODEALIVE_API_KEY が正しいことを確認します。
• 接続問題やその他の異常がないか確認します。

クライアントログの確認

使用しているクライアントに応じて、関連するログファイルを参照します。

• Claude Desktop:
  • macOS: /Users/your_username/Library/Logs/Claude/mcp.log
  • Windows: C:\Users\your_username\AppData\Local\Claude\logs\mcp.log
• Cursor: VS Code の出力パネルまたはコンソールを確認します。
• VS Code: 「開発者ツール」のログを確認します。

環境変数の検証

クライアント構成で CODEALIVE_API_KEY 環境変数が正しく設定されており、スペルミスやその他の形式上の問題がないことを確認します。

📄 ライセンス

CodeAlive MCP サーバーは MIT ライセンスに準拠しています。完全なライセンス条項と条件については、プロジェクトリポジトリを参照してください。

構成中に問題が発生した場合は、公式ドキュメント を参照するか、サポートチームに連絡してください (support@codealive.dev)。