Codex MCP Wrapper

エージェント型開発者向け MCP

このプロジェクトは、OpenAI の Codex CLI を MCP（Model Context Protocol）サーバーとしてラップし、TeaBranch/open-responses-server ミドルウェアを介して利用できるようにします。
このエンジンは OpenCode または Amazon Strands に置き換えられる場合があります。

要件

• Codex には Node 22（nvm install 22.15.1 | nvm use 22.15.1）が必要です。

概要

セットアップは、次の 3 つの主要コンポーネントで構成されます。

1. Codex CLI：Codex を操作するための OpenAI のコマンドラインインターフェースです。
2. MCP ラッパーサーバー：MCP リクエストを Codex CLI に転送し、レスポンスを MCP 形式に整える Node.js Express サーバーです。
3. open-responses-server：Responses API との互換性と MCP サポートを提供するミドルウェアサービスです。

インストール

Docker を使用する（推奨）

# Clone this repository
git clone https://github.com/yourusername/codex-mcp-wrapper.git
cd codex-mcp-wrapper

# Start the services
./start.sh

これにより、次のサービスが起動します。

• ポート 8080 の Codex MCP ラッパー
• ポート 3000 の open-responses-server

手動インストール

# Install dependencies
npm install

# Install Codex CLI globally
npm install -g @openai/codex

# Start the MCP server
node mcp-server.js
# Install the package in development mode
pip install -e .

使用方法

stdio または SSE トランスポートを使用して MCP サーバーを実行できます。

# Using stdio (default)
python -m mcp_server

# Using SSE on a specific port
python -m mcp_server --transport sse --port 8000

ツールドキュメント

run_codex

リポジトリをクローンし、（任意で）特定のブランチをチェックアウトし、（任意で）特定のフォルダーに移動して、指定されたリクエストで Codex を実行します。

パラメーター

• repository（必須）：Git リポジトリの URL
• branch（任意）：チェックアウトする Git ブランチ
• folder（任意）：対象とするリポジトリ内のフォルダー
• request（必須）：実行する Codex リクエスト／プロンプト

例

{
  "repository": "https://github.com/username/repo.git",
  "branch": "main",
  "folder": "src",
  "request": "Analyze this code and suggest improvements"
}

clone_and_write_prompt

リポジトリをクローンし、.agent/system.md からシステムプロンプトを読み込み、.agent/agent.json から modelId を解析し、リクエストを .prompt ファイルに書き込んだうえで、抽出したモデルを指定して Codex CLI を呼び出します。

パラメーター

• repository（必須）：Git リポジトリの URL
• request（必須）：Codex で実行するプロンプトのテキスト
• folder（任意、デフォルトは /）：操作対象となるリポジトリ内のサブフォルダー

例

{
  "repository": "https://github.com/username/repo.git",
  "folder": "src",
  "request": "Analyze this code and suggest improvements"
}

MCPS の設定

利用可能な MCP ツールを登録するには、.agent/ ディレクトリに mcps.json ファイルを配置してください。Codex はこの設定を自動的に読み込みます。

.agent/mcps.json の例：

{
  "mcpServers": {
    "agentic-developer-mcp": {
      "url": "..."
    }
  }
}

開発

このプロジェクトでは、MCP サーバーの実装に MCP Python SDK を使用しています。主な実装は mcp_server/server.py にあります。

ライセンス

MIT