# MCP Server — Research

多功能研究 MCP 服务器，整合了网页搜索、深度研究、网页抓取、研究方法路由和 GPT Researcher 报告生成。

## 安装

```bash
pip install -r requirements.txt
```

还需要安装 Chrome/Chromium 浏览器（供 Selenium/headless_dl.py 使用）。

## 配置

### 环境变量

| 变量 | 说明 | 必需 |
|------|------|------|
| `DOUBAO_API_KEY` | 豆包搜索 API Key | 否（有默认内置 Key，建议自备） |

### 可选组件

- **GPT Researcher**: `pip install gpt-researcher`（需要 OpenAI API Key 或其他 LLM 后端）
- **Selenium**: 已包含在 requirements.txt 中，需要 ChromeDriver

## 使用

在 `opencode.jsonc` 中添加：

```jsonc
{
  "mcpServers": {
    "research": {
      "type": "stdio",
      "command": "python",
      "args": ["path/to/research_mcp.py"],
      "env": {
        "DOUBAO_API_KEY": "your-key-here"
      }
    }
  }
}
```

## 工具

| 工具 | 说明 |
|------|------|
| `web_search(query, max_results)` | 网页搜索（豆包搜索 > DuckDuckGo 备选） |
| `web_fetch(url, mode, timeout)` | 下载网页/PDF 内容（使用 headless Chrome） |
| `deep_research(topic, depth, per_page)` | 多轮深度搜索 |
| `research_method(method)` | 研究方法路由 (causal-inference/finance/social-science/management/literature-review) |
| `gpt_research(query, report_type)` | GPT Researcher 深度研究报告 |

## 注意

- **API Key 安全**: 默认内嵌了一个豆包搜索 Key，建议通过环境变量 `DOUBAO_API_KEY` 设置自己的 Key
- **headless_dl.py**: 需要 Chrome/Chromium 浏览器和对应版本的 ChromeDriver