ARIA

An MCP server that autonomously researches any topic: searches the web, scrapes sources, extracts insights, builds a knowledge graph, and synthesizes a structured research brief — in under 90 seconds.

---

What It Does

Give ARIA a topic → it autonomously:

1. Searches the web for relevant sources (Tavily API)
2. Scrapes and cleans full page content (httpx + BeautifulSoup)
3. Extracts key concepts, claims, and gaps from each source (Claude API)
4. Builds a NetworkX knowledge graph of connected concepts
5. Synthesizes a final research brief with citations

---

Setup

1. Clone & create virtual environment

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

2. Configure API keys

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

Get keys from:

• Anthropic API: https://console.anthropic.com
• Tavily API: https://tavily.com (free tier works)

3. Connect to Claude Desktop

Open your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the ARIA server (replace the path with your actual absolute path):

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

Restart Claude Desktop. ARIA will appear as an available MCP tool.

4. Or use the CLI client

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

---

Project Structure

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

---

Testing Individual Modules

# 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

---

Team Split

Person	File	Responsibility
Person 1	tools/search.py	Web search via Tavily
Person 2	tools/scraper.py	URL scraping + text extraction
Person 3	tools/summarizer.py	Claude-powered summarization + synthesis
Person 4	tools/graph.py	Knowledge graph construction
All together	server/main.py	MCP server integration (Day 2)

---

Tech Stack

Layer	Tool
MCP Framework	mcp Python SDK by Anthropic
LLM	Claude Sonnet via Anthropic API
Web Search	Tavily API
Web Scraping	httpx + BeautifulSoup4
Knowledge Graph	NetworkX
Language	Python 3.11+

---

Demo

In Claude Desktop, type:

"Research the topic: Federated Learning in IoT devices"

ARIA will autonomously search 5 sources, scrape them, summarize each, build a knowledge graph, and produce a full research brief — all in real time.

---

License

MIT