# GPT Research MCP Server

OpenAI GPT-5.1 の Responses API と組み込み Web Search ツールを活用したリサーチ MCP サーバーです。

## 機能

- `research(query)`: GPT-5.1 の Web Search 機能を使用してクエリを調査し、引用情報付きの結果を返します

## 必要要件

- Python 3.12+
- [uv](https://docs.astral.sh/uv/) パッケージマネージャー
- OpenAI API キー

## セットアップ

### 1. リポジトリのクローン

```bash
git clone https://github.com/your-username/gpt-research-mcp.git
cd gpt-research-mcp
```

### 2. 依存関係のインストール

```bash
uv sync
```

### 3. 環境変数の設定

```bash
export OPENAI_API_KEY="sk-..."
```

#### カスタムエンドポイントの使用（オプション）

OpenAI 互換 API（Azure OpenAI、ローカル LLM など）を使用する場合は、`OPENAI_BASE_URL` を設定します:

```bash
export OPENAI_BASE_URL="https://your-custom-endpoint.com/v1"
```

設定しない場合は、デフォルトの `https://api.openai.com/v1/` が使用されます。

### 4. LangFuse トレーシング（オプション）

LangFuse を使用して OpenAI API 呼び出しの可観測性を有効にできます。以下の環境変数をすべて設定すると自動的に有効化されます:

```bash
export LANGFUSE_SECRET_KEY="sk-lf-..."
export LANGFUSE_PUBLIC_KEY="pk-lf-..."
export LANGFUSE_BASE_URL="https://cloud.langfuse.com"  # EU region
# export LANGFUSE_BASE_URL="https://us.cloud.langfuse.com"  # US region
```

環境変数が設定されていない場合は、通常の OpenAI SDK が使用されます。

## MCP サーバーとしてのインストール

### Claude Code への登録

```bash
claude mcp add gpt-research -- uv run --directory /path/to/gpt-research-mcp main.py
```

または `~/.claude/settings.json` に直接追加:

```json
{
  "mcpServers": {
    "gpt-research": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/gpt-research-mcp", "main.py"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "OPENAI_BASE_URL": "https://api.openai.com/v1/"
      }
    }
  }
}
```

`OPENAI_BASE_URL` はオプションです。カスタムエンドポイントを使用しない場合は省略可能です。

`/path/to/gpt-research-mcp` を実際のパスに置き換えてください。

## 使用方法

### スタンドアロン実行

```bash
uv run python main.py
```

### MCP ツールとして使用

MCP クライアント（Claude Desktop 等）から `research` ツールを呼び出します:

```
research("2024年の AI トレンドについて教えてください")
```

## ツール仕様

### `research(query: str) -> str`

| パラメータ | 型 | 説明 |
|-----------|-----|------|
| `query` | `str` | 調査したい質問やトピック |

**戻り値**: GPT-5.1 が生成したリサーチ結果（引用情報を含む）

## 技術スタック

| コンポーネント | 技術 |
|---------------|------|
| パッケージ管理 | uv |
| Python バージョン | 3.12 |
| MCP フレームワーク | FastMCP 2.0 |
| OpenAI クライアント | openai (公式ライブラリ) |
| モデル | gpt-5.1 |
| トレーシング（オプション） | LangFuse |