# 🎓 ArXiv Research Assistant (MCP Server)
An automated Research Agent server built with the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). This tool helps Data Scientists and Researchers search ArXiv, analyze papers, and discover insights using Machine Learning—all directly from their IDE.
## 🚀 Features
* automated Search: Query ArXiv for papers on any topic.
* Intelligent Extraction: Uses NLP heuristics to extract the core "Problem", "Method", and "Result" from abstracts.
* Data Science Pipeline:
* Saves findings to a structured dataset (`references.csv`).
* Visualize Trends: Generate charts of dominating research methods (`analyze_references.py`).
* Topic Modeling: Uses NMF (Non-Negative Matrix Factorization) to automatically discover hidden research themes (`topic_modeling.py`).
* Knowledge Graph: Generates an interactive HTML network graph of author collaborations (`generate_network.py`).
## Installation
### Prerequisites
* Python 3.10+ (Tested on Python 3.14)
### Setup
1. **Clone the repository**:
```bash
git clone <your-repo-url>
cd mcp-project
```
2. **Create a Virtual Environment**:
```bash
python3 -m venv .venv
source .venv/bin/activate
```
3. **Install Dependencies**:
```bash
pip install -r requirements.txt
```
## ⚙️ Configuration
Add the server to your IDE's MCP settings (e.g., `mcp-servers.json` in VS Code or Claude Desktop):
```json
{
"mcpServers": {
"research-assistant": {
"command": "/absolute/path/to/your/mcp-project/.venv/bin/python",
"args": [
"/absolute/path/to/your/mcp-project/research_server.py"
],
"env": {
"PYTHONPATH": "/absolute/path/to/your/mcp-project"
}
}
}
}
```
*Note: Replace `/absolute/path/to/your/mcp-project/` with the actual full path on your machine.*
## 💡 Usage
### 1. The MCP Agent
Once configured, you can ask your AI Assistant commands like:
> "Find 5 papers on 'Reinforcement Learning from Human Feedback', extract their key findings, and save them to my bibliography."
### 2. Analysis Tools
Run these scripts to generate insights from your collected `references.csv`:
* **Visualize Keyword Trends**:
```bash
python analyze_references.py
```
*Generates `method_keywords.png`.*
* **View Author Network**:
```bash
python generate_network.py
```
*Generates `author_network.html` (interactive).*
* **Discover Hidden Topics**:
```bash
python topic_modeling.py
```
*Generates `references_with_topics.csv` with ML-assigned topic clusters.*
## 📂 Project Structure
- `research_server.py`: The core MCP server logic.
- `analyze_references.py`: Visualization script for keyword frequencies.
- `generate_network.py`: NetworkX/Pyvis script for knowledge graphs.
- `topic_modeling.py`: Scikit-learn script for NMF topic modeling.
- `references.csv`: The dataset built by the agent.
- `requirements.txt`: Python dependencies.
---
*Built with [mcp](https://pypi.org/project/mcp/), [arxiv](https://pypi.org/project/arxiv/), [pandas](https://pandas.pydata.org/), [scikit-learn](https://scikit-learn.org/), and [networkx](https://networkx.org/).*
# arxiv-research-mcp
# arxiv-research-mcp
