ArXiv Research Assistant

This MCP server lets you automate ArXiv research tasks from your IDE. You can search for papers, extract core insights from abstracts, save findings to a structured dataset, visualize trends, discover hidden topics, and generate a knowledge graph of author collaborations. It acts as your data science assistant, streamlining literature review and analysis through repeated, reproducible workflows.

How to use

Connect the MCP client to your local server and start issuing commands to perform end-to-end research tasks. You can ask the agent to find papers on a topic, extract key findings such as the Problem, Method, and Result, and save them to your bibliography. Then run the analysis tools to visualize keyword trends, generate topic models, and create an interactive author network. Use the workflow verbs below to guide your prompts.

Practical usage patterns you can run: you can ask for a batch of papers, have the agent extract core insights, and save results to references.csv. Then you can visualize trends with analyze_references.py, discover hidden topics with topic_modeling.py, and build an interactive knowledge graph with generate_network.py. You can repeat these steps for different topics and time ranges to build a comprehensive literature overview.

How to install

Prerequisites: you need Python 3.10 or newer.

Step 1: Clone the project and enter the directory.

git clone <your-repo-url>
cd mcp-project

Step 2: Create and activate a virtual environment.

python3 -m venv .venv
source .venv/bin/activate

Step 3: Install dependencies from the requirements file.

pip install -r requirements.txt

Configuration and run instructions

Configure your MCP client to connect to the local server using the provided stdio command. The server runs in a virtual environment and is started by invoking Python on the MCP script.

{
  "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"
      }
    }
  }
}

Usage notes

After configuration, you can send prompts to your MCP client to execute the AI-assisted research flow. The agent will search ArXiv, extract structured insights, and persist them to references.csv. The analysis scripts can then render visualizations and topic models, while the network script creates an interactive collaboration graph.

Troubleshooting and tips

If the agent cannot start, ensure the virtual environment is activated and that the path to the project is correct in the configuration file. Verify that dependencies install without errors and that your Python version matches the prerequisite. For environment-related issues, confirm that PYTHONPATH points to your project root.

Available tools

Search

Automates querying ArXiv for papers on a topic and returns relevant results.

Extraction

Intelligently extracts the core elements from abstracts: Problem, Method, and Result.

Save Dataset

Saves findings to a structured dataset named references.csv for further analysis.

Visualize Trends

Generates visualizations of keyword or method trends from references.csv.

Topic Modeling

Applies NMF to discover hidden themes in the collected references.

Knowledge Graph

Creates an interactive HTML network graph of author collaborations.