metadata

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

Fork or Clone

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!