@nekobato/chatgpt-websearch-mcp/README.ja.md

A local MCP stdio server that provides access to the OpenAI (ChatGPT) API with web search capabilities for Claude Code and other MCP clients.

# ChatGPT WebSearch MCP

Claude Codeやその他のMCPクライアント向けに、OpenAI (ChatGPT) APIへのアクセスを提供するローカルMCP stdioサーバーです。Web検索が有効なモデルに対応しています。

---

## 使用方法

### Claude Code

```sh
$ claude mcp add chatgpt-websearch \
	-s user \  # この行を省略すると、プロジェクトスコープでインストールされます
	-e OPENAI_API_KEY=your-api-key \
	-- npx @nekobato/chatgpt-websearch-mcp
```

### またはconfigでの設定

```jsonc
{
  "mcpServers": {
    "chatgpt-websearch": {
      "command": "npx",
      "args": ["@nekobato/chatgpt-websearch-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-api-key",
        ...
      },
    },
  },
}
```

### 環境変数

以下の環境変数を使用してデフォルト値を設定できます：

- `OPENAI_API_KEY` (必須): OpenAI APIキー
- `OPENAI_DEFAULT_MODEL` (オプション): 使用するデフォルトモデル（デフォルト: gpt-5）
- `REASONING_EFFORT` (オプション): 推論モデルのデフォルト推論effortレベル（minimal|low|medium|high）
- `SEARCH_CONTEXT_SIZE` (オプション): デフォルトの詳細度レベル（low|medium|high）
- `OPENAI_MAX_RETRIES` (オプション): デフォルトの最大リトライ回数（デフォルト: 3）
- `OPENAI_API_TIMEOUT` (オプション): デフォルトのAPIタイムアウト（ミリ秒）。設定されていない場合、effortレベルに基づいて自動調整：
  - `minimal/low`: 60000（1分）
  - `medium`: 120000（2分）
  - `high`: 300000（5分）

## API

### MCPツール

- `ask_chatgpt`: ChatGPTにプロンプトを送信してレスポンスを受信
  - `prompt` (必須): 送信するプロンプト
  - `model` (オプション): 使用するモデル（デフォルト: OPENAI_DEFAULT_MODEL環境変数またはgpt-5）
  - `system` (オプション): コンテキストと動作を設定するシステムプロンプト
  - `temperature` (オプション): レスポンス生成の温度（0-2、デフォルト: 0.7）- 推論モデルでは利用不可
  - `effort` (オプション): 推論effortレベル（minimal|low|medium|high、デフォルト: REASONING_EFFORT環境変数）- 推論モデル専用
  - `verbosity` (オプション): 出力の詳細度（low|medium|high、デフォルト: SEARCH_CONTEXT_SIZE環境変数）- 推論モデル専用
  - `maxTokens` (オプション): 最大出力トークン数
  - `maxRetries` (オプション): 最大APIリトライ回数（デフォルト: OPENAI_MAX_RETRIES環境変数または3）
  - `timeoutMs` (オプション): リクエストタイムアウト（ミリ秒）。effortレベルに基づいて自動調整（high=300秒、medium=120秒、low/minimal=60秒）
  - `useStreaming` (オプション): タイムアウトを防ぐためにストリーミングモードを強制。medium/high effort推論モデルでは自動有効化

## 開発

### 要件

- Node.js 22+
- `OPENAI_API_KEY`にOpenAI APIキー

### コマンド

```bash
# 依存関係のインストール
pnpm install

# 開発モードで実行
pnpm dev

# プロダクション用にビルド
pnpm build

# テストを実行
pnpm test

# コードをリント
pnpm lint

# コードをフォーマット
pnpm format
```

## ライセンス

MIT License