openai-deep-research

MCP浏览器工具

提供方 aaron-official

浏览器工具 Streamable HTTP API Key 社区 / 第三方
查看接入方式

This is a multi-agent deep research system built on the OpenAI Agents SDK and Docker MCP Gateway, integrating web search, browser automation, and email delivery to support the full workflow from research planning and information retrieval to long-form report generation and delivery.

一句话选型结论

按资料字段整理

openai-deep-research 属于浏览器工具类 MCP 服务器,Streamable HTTP,API Key,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类浏览器工具 传输方式Streamable HTTP 鉴权API Key 部署方式支持远程部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

浏览器工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

Blend Deployment Deep Research Multi-Agent Python Web Search Report Generation Email Delivery Browser Automation Chat Interface OpenAI Agents SDK

适用场景

Blend DeploymentDeep ResearchMulti-Agent

安装与配置

Streamable HTTP API Key
新一代远程传输,替代 SSE
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
自动操作网页

打开页面、点击、填表,把浏览器动作交给模型执行。

抓取结构化数据

把页面内容整理成表格或 JSON,省掉手工复制粘贴。

关键流程回归

按步骤检查页面是否正常,回归时少漏环节。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在浏览器工具场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
openai-deep-research当前 未标注 Streamable HTTP 支持远程部署 有 2026-09-05
Playwright MCP Server 21 stdio · 本地进程 本地部署 有 2026-05-18
Fetch 9a2682de 1 SSE · 服务端推送 支持远程部署 有 2026-05-18
Browser 738d52bc 未标注 stdio · 本地进程 本地部署 有 2026-05-17
MCP 40600ece 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Skyvern MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

浏览器工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方aaron-official上游标注的维护方 aaron-official
分类浏览器工具本站按上游分类展示
连接方式Streamable HTTP新一代远程传输,替代 SSE
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · python本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-09-05上游最后核验时间

详细介绍

4.7 KB
来自项目仓库与上游目录的原文,未做删改

Deep Research Agent (OpenAI Agents + Docker MCP)

This project is a multi-agent deep research system built on top of the OpenAI Agents SDK and Docker MCP Gateway.

It is designed as a professional-grade application that combines web research, long-form synthesis, and email delivery in a single workflow.

Key capabilities

  • Multi-step query clarification and scope negotiation
  • Search planning with structured Pydantic models
  • Web search via Tavily MCP and browser automation via Playwright MCP
  • Parallel search execution with streaming progress updates
  • Long-form markdown report generation with follow-up questions
  • Email delivery using SendGrid
  • Chat-style Gradio UI that surfaces the agent's internal reasoning (planning, searches, writing, email)

Architecture

Main components in this folder:

  • deep_research.py – Gradio UI (chat interface) and app entrypoint
  • research_manager.py – Orchestrator that runs the full pipeline
  • planner_agent.py – Plans WebSearchItems using OpenAI Agents SDK
  • search_agent.py – Uses MCP (Tavily + Playwright) for web search
  • writer_agent.py – Turns search results into a long markdown report
  • email_agent.py – Sends the report via SendGrid
  • clarifier_agent.py – Clarifies the user query and asks for confirmation

Control flow:

  1. User enters a topic in the chat UI
  2. clarifier_agent analyzes the request, proposes a scope, and asks for confirmation
  3. On confirmation, research_manager:
    - Connects to Docker MCP Gateway (MCPServerStreamableHttp)
    - Asks planner_agent for 5 search queries
    - Runs search_agent in parallel for each query (Tavily + Playwright MCP tools)
    - Calls writer_agent to synthesize a detailed markdown report
    - Calls email_agent to send the report as HTML via SendGrid
  4. Progress and thoughts are streamed back into the chat (planning, each search, report, email)

Requirements

This subproject is isolated from the rest of the repo and only needs:

See requirements.txt:```txt
openai-agents==0.0.15
openai==1.68.2
gradio==5.22.0
python-dotenv==1.1.1
pydantic==2.11.9
sendgrid==6.11.0


Install into a fresh virtualenv:```bash
pip install -r requirements.txt

Using uv (optional)

If you use uv, you can create the environment and run the app with:```bash

From this folder

Create a virtual environment managed by uv

uv venv .venv

Install dependencies from requirements.txt

uv pip install -r requirements.txt

Run the app

uv run python deep_research.py


> Note: The `agents` package at the repo root provides the custom Agent abstractions that this project imports.

---

## Environment Variables

Create a `.env` file in this folder with at least:```env
OPENAI_API_KEY=sk-...
SENDGRID_API_KEY=...

You may also want:```env

Optional: model overrides, etc.

DEEP_RESEARCH_MODEL=...


The app loads this file via `python-dotenv` in `deep_research.py`.

---

## Docker MCP Gateway Setup

This app expects a running **Docker MCP Gateway** exposing Tavily and Playwright MCP servers on `http://localhost:8081/mcp`.

### 1. Enable MCP Toolkit in Docker Desktop

1. Open Docker Desktop → Settings → Beta features
2. Enable **Docker MCP Toolkit**

### 2. Enable required MCP servers

In a terminal:```bash
docker mcp server enable tavily
docker mcp server enable playwright

Configure API keys (example for Tavily):```bash
docker mcp config write '
servers:
tavily:
env:
TAVILY_API_KEY: your_tavily_key_here
'


### 3. Run the gateway```bash
docker mcp gateway run --port 8081 --transport streaming

research_manager.py connects via:```python
MCP_GATEWAY_URL = "http://localhost:8081/mcp"


---

## Running the App

From this folder:```bash
python deep_research.py

Then open the printed local URL (usually http://127.0.0.1:7860).

Workflow in the UI:

  1. Enter a research question (e.g. "Latest developments in quantum computing")
  2. The assistant:
    - Clarifies your request and proposes a research scope
    - Asks you to confirm or refine
  3. Reply with confirmation (e.g. "yes", "sure, go ahead", "yeah proceed") or refine the scope
  4. Once confirmed, you will see live updates:
    - Connecting to MCP Gateway
    - Planning searches
    - Each web search as it completes
    - Report drafting
    - Email sending status
  5. Final message contains the full markdown report + follow-up questions

Notes

  • This project is intended as a reference implementation; you should review and adapt email recipients in email_agent.py (and related security settings) before using it in production.
  • The MCP setup assumes Docker MCP Toolkit is installed and configured on your machine.
  • Models used are gpt-4o-mini via the OpenAI Agents SDK.

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
openai-deep-research 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

openai-deep-research 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

openai-deep-research 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

openai-deep-research 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

openai-deep-research 能提供哪些能力?

资料显示能力标签包括 Blend Deployment、Deep Research、Multi-Agent、Python、Web Search、Report Generation。具体工具清单以官方文档为准。

openai-deep-research 需要什么运行环境?

运行时为 python;属于远程端点,不需要在本地装运行时。

openai-deep-research 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为Streamable HTTP。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-09-05。