git clone https://github.com/YOUR_USERNAME/aria-mcp.git
cd aria-mcp
python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt

cp .env.example .env
# Open .env and fill in your keys

{
  "mcpServers": {
    "aria": {
      "command": "python",
      "args": ["/absolute/path/to/aria-mcp/server/main.py"]
    }
  }
}

cd client
python aria_client.py "federated learning in healthcare"
python aria_client.py "transformer architecture" 3

aria-mcp/
├── server/
│   ├── main.py                  ← MCP server entry point (integration)
│   ├── tools/
│   │   ├── search.py            ← Tavily web search
│   │   ├── scraper.py           ← httpx + BeautifulSoup scraper
│   │   ├── summarizer.py        ← Claude-powered insight extraction
│   │   └── graph.py             ← NetworkX knowledge graph
│   └── utils/
│       └── helpers.py           ← Shared utilities
├── client/
│   └── aria_client.py           ← CLI demo client
├── tests/
│   ├── test_search.py
│   ├── test_scraper.py
│   ├── test_summarizer.py
│   └── test_graph.py
├── output/                      ← Research JSON results (gitignored)
├── .env.example
├── .gitignore
├── claude_desktop_config.json   ← Claude Desktop config snippet
├── requirements.txt
└── README.md

# From project root, with venv activated
python tests/test_search.py
python tests/test_scraper.py
python tests/test_summarizer.py
python tests/test_graph.py