OpenAI Codex MCP Server

OpenAI Codex MCP サーバー

OpenAI Codex CLI を MCP（Model Context Protocol）サーバーとしてラップし、Claude と連携します。

🚀 機能

この MCP サーバーは、次のツールを提供します。

• codex_agent：OpenAI Codex CLI のすべての機能を利用できる包括的なツール

  • コードの生成、説明、デバッグ、リファクタリング
  • セキュリティ分析、テストの作成、ドキュメントの生成
  • マルチモーダル対応（画像入力）
  • 複数の AI プロバイダーに対応
  • 3 段階の自動化モード（提案／自動編集／完全自動）

• codex_interactive：対話型セッションを開始するツール

🔌 対応モード

• stdio モード：標準入出力を使用します（Claude Desktop 用）
• SSE モード：Server-Sent Events を使用します（Web API 用）

📋 前提条件

1. OpenAI Codex CLI：

   npm install -g @openai/codex
   

2. Python 3.12 以降

3. 環境のセットアップ：.env.example を .env にコピーし、設定します

🛠️ インストール

1. リポジトリをクローンする

git clone https://github.com/Tomatio13/openai-codex-mcp.git
cd openai-codex-mcp

2. セットアップ

./setup.sh

3. サーバーを起動する

stdio モード（Claude Desktop 用）

./run.sh

SSE モード（Web API 用）

./run_sse.sh [port] [host]

# Examples:
./run_sse.sh 8080 0.0.0.0  # Port 8080, listen on all interfaces
./run_sse.sh              # Default: localhost:8000

手動で起動する

# stdio mode
python codex_server.py --mode stdio

# SSE mode
python codex_server.py --mode sse --port 8000 --host localhost

または、セットアップと起動を 1 つのコマンドで実行します。

./setup_and_run.sh

手動インストール

# Install dependencies
pip install -e .

# Start server
python codex_server.py

🔧 Claude の設定

stdio モード（推奨）

Claude Desktop で MCP サーバーを使用するには、次の内容を設定ファイルに追加します。

macOS

~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "openai-codex": {
      "command": "python",
      "args": ["/path/to/openai-codex-mcp/codex_server.py", "--mode", "stdio"],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Windows

%APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "openai-codex": {
      "command": "python",
      "args": ["C:\\path\\to\\openai-codex-mcp\\codex_server.py", "--mode", "stdio"],
      "env": {
        "PATH": "C:\\Program Files\\nodejs;C:\\Windows\\System32"
      }
    }
  }
}

SSE モード

SSE モードでは、HTTP エンドポイント経由で MCP サーバーにアクセスできます。

# Start server
./run_sse.sh 8000

# Available endpoints
# GET  http://localhost:8000/sse - SSE connection
# POST http://localhost:8000/message - Send message

💡 使い方

Claude Desktop で MCP サーバーを設定すると、次のようにツールを使用できます。

基本的なコード生成

@openai-codex codex_agent prompt="Create a Python function to calculate Fibonacci numbers"

タスクに応じた最適化

@openai-codex codex_agent prompt="Explain this code" task_type="code-explanation"
@openai-codex codex_agent prompt="Fix the bug in utils.py" task_type="debugging" model="o4-preview"
@openai-codex codex_agent prompt="Check for security vulnerabilities" task_type="security"

自動化レベルの設定

# Suggestions only (default, safest)
@openai-codex codex_agent prompt="Refactor this code" approval_mode="suggest"

# Auto-edit (automatic file read/write, command execution requires confirmation)
@openai-codex codex_agent prompt="Explain this codebase" approval_mode="auto-edit"

# Full auto (fully automatic execution in network-disabled sandbox)
@openai-codex codex_agent prompt="Create and run tests" approval_mode="full-auto"

マルチモーダル（画像入力）

@openai-codex codex_agent prompt="Implement this UI design" images=["design.png"] task_type="code-generation"

異なる AI プロバイダーを使用する

@openai-codex codex_agent prompt="Review this code" provider="azure" model="gpt-4.1"
@openai-codex codex_agent prompt="Explain this" provider="ollama" model="llama3"

対話型セッション

@openai-codex codex_interactive initial_prompt="Tell me about the project structure" approval_mode="auto-edit"

🎯 タスクの種類

task_type パラメーターを使用して、特定のタスクに最適化されたプロンプトを生成します。

• general：一般的なコーディング支援（デフォルト）
• code-generation：新しいコードを生成する
• code-explanation：既存のコードを説明する
• debugging：バグを見つけて修正する
• refactoring：コード構造を改善する
• testing：テストを作成または修正する
• security：セキュリティ分析と修正を行う
• documentation：ドキュメントを生成または改善する

🤖 AI プロバイダー

provider パラメーターを使用して、次の AI プロバイダーを利用できます。

• openai：OpenAI（デフォルト）
• azure：Azure OpenAI
• gemini：Google Gemini
• ollama：Ollama（ローカルモデル）
• mistral：Mistral AI
• deepseek：DeepSeek
• xai：xAI
• groq：Groq

🔒 承認モード

• suggest：変更の提案のみを行い、すべての操作に承認が必要です（最も安全）
• auto-edit：ファイルを自動的に読み書きでき、シェルコマンドの実行時には確認を求めます
• full-auto：ネットワークが無効化されたサンドボックス内で完全に自律的に動作します（最も強力）

🛡️ セキュリティ

• セキュリティ確保のため、full-auto モードはネットワークが無効化されたサンドボックス内で実行されます
• ファイル操作は現在の作業ディレクトリ内に制限されます
• full-auto モード以外では、すべてのシェルコマンドに明示的な承認が必要です

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

よくある問題

1. 「codex command not found」

   npm install -g @openai/codex
   

2. スクリプトの実行権限がありません

   chmod +x *.sh
   

3. Python のバージョンに関する問題

   • Python 3.12 以降がインストールされていることを確認してください
   • 仮想環境を使用してください：python3 -m venv venv && source venv/bin/activate

4. MCP 接続に関する問題

   • Claude Desktop の設定ファイルの構文を確認してください
   • ファイルパスが絶対パスであることを確認してください
   • 設定を変更した後、Claude Desktop を再起動してください

📝 ライセンス

MIT License with Attribution — 詳細は LICENSE ファイルをご覧ください。

🤝 コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を送信してください。

📞 サポート

問題が発生した場合や質問がある場合は、GitHub で issue を作成してください。

---

Claude + OpenAI Codex コミュニティのために ❤️ を込めて作成