---
title: MCP Research
emoji: 🚀
colorFrom: red
colorTo: red
sdk: docker
app_port: 8501
tags:
- streamlit
pinned: false
short_description: Streamlit template space
---

# AI-Powered Scientific Research Companion

Welcome to your AI-driven research assistant—hosted as a Hugging Face Space!

---

## 🚀 Live Demo

👉 https://huggingface.co/spaces/your-username/MCP_Research

---

## Features

- 🔍 **One-Click Discovery**  
  Search academic articles, preprints, and the open web via MCP servers (`pskill9/web-search`, `metatool-ai/metatool-app`).

- 📓 **Reproducible Notebook**  
  Fetch and run code snippets for core experiments using a Python-run MCP sandbox.

- 🔗 **Interactive Knowledge Graph**  
  Build and explore concept‐and‐method graphs via a vector-store MCP (Chroma).

- 🛠️ **Provenance Tracking**  
  Store metadata and execution history in a SQL database via MCP.

- 🎨 **Light & Dark Themes**  
  Toggle UI themes for day/night readability.

---

## 🔧 Setup

1. **Fork or Clone**  
   ```bash
   git clone https://huggingface.co/spaces/your-username/MCP_Research.git
   cd MCP_Research
Configure Endpoints
Copy and edit config.example.yaml → config.yaml:

yaml
Copy code
mcp_servers:
  web_search:  http://localhost:3000
  pubmed:      http://localhost:3001
  chroma:      http://localhost:3002
  python_run:  http://localhost:3003
db_url:       sqlite:///embeddings.db
Install Dependencies

bash
Copy code
pip install -r requirements.txt
Run Locally (optional)

bash
Copy code
streamlit run app.py --server.port 8501 --server.address 0.0.0.0
📦 Deployment on Hugging Face
Create a New Space

Choose Streamlit as the runtime.

Push your repo to the Space.

Environment Variables / Secrets
In your Space’s Settings → Secrets, add any API keys or credentials required by your MCP endpoints.

Automatic Build & Launch
HF will install from requirements.txt and launch app.py automatically.

📁 Project Layout
arduino
Copy code
├── .gitignore
├── README.md
├── config.yaml
├── requirements.txt
├── Dockerfile
├── app.py
├── orchestrator/
│   ├── client.py
│   ├── dispatcher.py
│   └── provenance.py
├── components/
│   ├── sidebar.py
│   ├── paper_list.py
│   ├── notebook_view.py
│   └── graph_view.py
├── scripts/
│   ├── ingest.py
│   └── reindex.py
└── demo.ipynb
🤝 Contribute
⭐ Star this Space

🐛 Report issues or suggest features

🔀 Submit PRs — we welcome enhancements and new MCP integrations!

📜 License
MIT © 2025