openai-responses-mcp

OpenAI Responses API を推論コアに採用した軽量な MCP サーバです。 web_search を常時許可し、実際に検索を行うかはモデルが自律判断します。Claude Code 等の MCP クライアントから stdio で利用します。

重要: 仕様・挙動は実装が正です。まず docs/spec.md を読んでください。

---

• src/ : TypeScript ソース
• scripts/ : 検証/補助スクリプト。例: mcp-smoke*, clean.js
• config/
• config.yaml.example : 設定サンプル
• policy.md.example : 外部 System Policy のサンプル
• docs/ : 正準仕様/リファレンス/検証手順
• spec.md : 正準仕様
• reference/ : 設定・導入・連携リファレンス
• verification.md : E2E 検証手順
• README.md : プロジェクト概要/クイックスタート
• LICENSE : ライセンス
• package.json, package-lock.json : npm 設定/依存固定
• tsconfig.json : TypeScript 設定
• .gitignore : Git 除外設定

---

• Responses API 準拠（公式JS SDK openai）
• 検索はモデルに委譲（web_search を常時許可）
• 構造化出力は answer 本文、used_search、citations[]、model を返す
• citations[] は 情報源（URL または oai-weather 等の情報源ID）を返す
• System Policy の参照先: src/policy/system-policy.ts
• MCP stdio 実装（initialize/tools/list/tools/call）

• OS: macOS / Linux
• Node.js: 必須は v24 系。CI / Release ともに v24 系で運用。
• npm（Node 同梱）
• OpenAI API キー（環境変数で渡す）

---

• 必須設定: 環境変数 OPENAI_API_KEY のみ。
• 起動例:
• export OPENAI_API_KEY="sk-..." && npx openai-responses-mcp@latest --stdio

使う場合の既定パスは ~/.config/openai-responses-mcp/config.yaml です。

---

MCPクライアントから利用する場合に参考にしてください。

• ~/.claude.json へ以下の項目を追加

{
  "mcpServers": {
    "openai-responses": {
      "command": "npx",
      "args": ["openai-responses-mcp@latest", "--stdio"],
      "env": { "OPENAI_API_KEY": "sk-..." }
    }
  }
}

• Claude Code CLI では以下を実行

claude mcp add -s user -t stdio openai-responses -e OPENAI_API_KEY=sk-xxxx -- npx openai-responses-mcp@latest --stdio