O3 Search MCP

🚀 o3-search-mcp

OpenAIのo3モデルとその強力なウェブ検索機能を使用できるようにするMCPサーバーです。 任意のAIコーディングエージェントに登録することで、エージェントは自動的にo3モデルに相談して複雑な問題を解決できます。

🚀 クイックスタート

このサーバーを利用することで、AIコーディングエージェントがOpenAIのo3モデルとウェブ検索機能を活用して、様々な問題を解決できるようになります。以下に具体的な使用例を示します。

✨ 主な機能

🐛 デバッグに困ったとき

o3のウェブ検索機能は、GitHubのissueやStack Overflowなど幅広い情報源をスキャンし、特殊な問題を解決する可能性を大幅に高めます。例えば以下のようなプロンプトを使用できます。

> 起動時に次のエラーが発生します。修正してください。難しい場合はo3に相談してください。
> [ここにエラーメッセージを貼り付ける]

> WebSocket接続が機能していません。デバッグしてください。方法がわからない場合はo3に相談してください。

📚 最新のライブラリ情報を参照したいとき

整理されたドキュメントがない場合でも、強力なウェブ検索機能から答えを得ることができます。例えば以下のようなプロンプトを使用できます。

> このライブラリをv2にアップグレードしたいです。o3に相談しながら進めてください。

> このライブラリのこのオプションは存在しないと言われました。削除された可能性があります。o3に代わりに指定すべきものを尋ねて置き換えてください。

🧩 複雑なタスクに取り組むとき

検索機能だけでなく、設計の相談相手としても利用できます。例えば以下のようなプロンプトを使用できます。

> 共同編集エディタを作成したいので、設計してください。また、o3に設計レビューを依頼し、必要に応じて議論してください。

また、これはMCPサーバーとして提供されているため、AIエージェントは必要と判断したときに、あなたからの指示なしに自動的にo3と話し合うことができます。これにより、エージェントが独自に解決できる問題の範囲が大幅に拡大します！

📦 インストール

npx (推奨)

Claude Code:

$ claude mcp add o3 \
    -s user \  # この行を省略すると、プロジェクトスコープにインストールされます
    -e OPENAI_API_KEY=your-api-key \
    -e SEARCH_CONTEXT_SIZE=medium \
    -e REASONING_EFFORT=medium \
    -e OPENAI_API_TIMEOUT=60000 \
    -e OPENAI_MAX_RETRIES=3 \
    -- npx o3-search-mcp

json:

{
  "mcpServers": {
    "o3-search": {
      "command": "npx",
      "args": ["o3-search-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-api-key",
        // オプション: low, medium, high (デフォルト: medium)
        "SEARCH_CONTEXT_SIZE": "medium",
        "REASONING_EFFORT": "medium",
        // オプション: APIタイムアウト（ミリ秒） (デフォルト: 60000)
        "OPENAI_API_TIMEOUT": "60000",
        // オプション: 最大リトライ回数 (デフォルト: 3)
        "OPENAI_MAX_RETRIES": "3"
      }
    }
  }
}

ローカルセットアップ

コードをダウンロードしてローカルで実行する場合は、以下の手順を実行します。

git clone git@github.com:yoshiko-pg/o3-search-mcp.git
cd o3-search-mcp
pnpm install
pnpm build

Claude Code:

$ claude mcp add o3 \
    -s user \  # この行を省略すると、プロジェクトスコープにインストールされます
    -e OPENAI_API_KEY=your-api-key \
    -e SEARCH_CONTEXT_SIZE=medium \
    -e REASONING_EFFORT=medium \
    -e OPENAI_API_TIMEOUT=60000 \
    -e OPENAI_MAX_RETRIES=3 \
    -- node /path/to/o3-search-mcp/build/index.js

json:

{
  "mcpServers": {
    "o3-search": {
      "command": "node",
      "args": ["/path/to/o3-search-mcp/build/index.js"],
      "env": {
        "OPENAI_API_KEY": "your-api-key",
        // オプション: low, medium, high (デフォルト: medium)
        "SEARCH_CONTEXT_SIZE": "medium",
        "REASONING_EFFORT": "medium",
        // オプション: APIタイムアウト（ミリ秒） (デフォルト: 60000)
        "OPENAI_API_TIMEOUT": "60000",
        // オプション: 最大リトライ回数 (デフォルト: 3)
        "OPENAI_MAX_RETRIES": "3"
      }
    }
  }
}

📚 ドキュメント

環境変数

🔧 技術詳細

注意事項

OpenAI APIからo3モデルを使用するには、Tierを4に引き上げるか、組織を認証する必要があります。 o3がまだ有効になっていないAPIキーをこのMCPに登録すると、呼び出しはエラーになります。 参考: https://help.openai.com/en/articles/10362446-api-access-to-o1-o3-and-o4-models