graph TD
    classDef inputNode fill:#1E293B,stroke:#38BDF8,stroke-width:2px,color:#F8FAFC;
    classDef stageNode fill:#0F172A,stroke:#818CF8,stroke-width:2px,color:#F8FAFC;
    classDef outputNode fill:#064E3B,stroke:#34D399,stroke-width:2px,color:#FFF;

    Topic["🎯 User Research Query / Topic"]:::inputNode

    subgraph AutonomousResearchPipeline ["🔄 Multi-Stage Agno Workflow Engine"]
        Topic --> Searcher["🔍 Searcher Agent<br/><i>(Scrapegraph AI & Web Extraction)</i>"]:::stageNode
        Searcher --> Analyst["📊 Analyst Agent<br/><i>(Pattern synthesis & data normalization)</i>"]:::stageNode
        Analyst --> Writer["✍️ Writer Agent<br/><i>(Markdown synthesis with inline citations)</i>"]:::stageNode
    end

    subgraph ClientInterfaces ["🔌 Delivery Channels"]
        Writer --> StreamlitUI["💻 Streamlit Web UI<br/><i>(Interactive research exploration)</i>"]:::outputNode
        Writer --> MCPServer["🔌 Native MCP Server<br/><i>(Direct tool in Claude Desktop & Cursor)</i>"]:::outputNode
    end

deep-researcher-agent-mcp/
├── app.py                  # Streamlit web interface
├── agents.py               # Core multi-stage agent pipeline (Searcher, Analyst, Writer)
├── server.py               # Native Model Context Protocol (MCP) server
├── assets/                 # Architecture graphics and demo assets
├── pyproject.toml          # uv / pip dependency specifications
├── .env.example            # API key template
├── .gitignore              # Git ignore rules
└── LICENSE                 # MIT License

# Clone the repository
git clone https://github.com/blue007-arc/deep-researcher-agent-mcp.git
cd deep-researcher-agent-mcp

# Install dependencies with uv
uv sync

cp .env.example .env

NEBIUS_API_KEY=your_nebius_api_key_here
SGAI_API_KEY=your_scrapegraph_api_key_here

uv run streamlit run app.py

uv run python agents.py

{
  "mcpServers": {
    "deep_researcher": {
      "command": "python",
      "args": [
        "run",
        "server.py"
      ],
      "env": {
        "NEBIUS_API_KEY": "your_nebius_api_key_here",
        "SGAI_API_KEY": "your_scrapegraph_api_key_here"
      }
    }
  }
}