Copy page

Guides

ArXiv MCP Server

This example demonstrates how to deploy the ArXiv MCP server on Unikraft Cloud.

The ArXiv MCP Server is a third-party library that provides stdio-based MCP tools for accessing arXiv research papers. This example uses FastMCP 2.0 to create a proxy MCP server that exposes these tools over streamable HTTP.

The server gives AI agents and assistants the ability to:

• Search for papers with filters for date ranges and categories
• Download and read paper content
• List downloaded papers
• Analyze papers using specialized prompts.

Running on Unikraft Cloud

To run this MCP server on Unikraft Cloud:

1. Install the CLI and a container runtime engine, for example Docker. Use the unikraft CLI or the legacy kraft CLI.

2. Clone the examples repository and cd into the examples/mcp-server-arxiv/ directory:

Code
git clone https://github.com/unikraft-cloud/examples
cd examples/mcp-server-arxiv/

Make sure to log into Unikraft Cloud and pick a metro close to you. This guide uses fra (Frankfurt, 🇩🇪):

When done, invoke the following command to deploy this app on Unikraft Cloud:

The output shows your instance details:

Code
[●] Deployed successfully!
 │
 ├─────── name: mcp-server-arxiv-l7l24
 ├─────── uuid: 1a721bb8-4472-4149-9870-789b1df5f80a
 ├────── metro: https://api.fra.unikraft.cloud/v1
 ├────── state: starting
 ├───── domain: https://billowing-breeze-nuusy7l2.fra.unikraft.app
 ├────── image: mcp-server-arxiv@sha256:ea1e677ccc03628a3e7d57a4cd41118e3d2a631bcb2c34203bb9b175e7977f00
 ├───── memory: 2048 MiB
 ├──── service: billowing-breeze-nuusy7l2
 ├─ private ip: 10.0.1.149
 └─────── args: /usr/local/bin/python /src/server.py

In this case, the instance name is mcp-server-arxiv-l7l24 and the service billowing-breeze-nuusy7l2. They're different for each run.

For testing, you can use the example client included in this directory. First, install uv if you haven't already, then run:

Code
export MCP_SERVER_URL=https://billowing-breeze-nuusy7l2.fra.unikraft.app/mcp
uv run client.py

Code
Connecting to https://billowing-breeze-nuusy7l2.fra.unikraft.app/mcp...

--- Listing Tools ---
Name: search_papers
Description: Search for papers on arXiv with advanced filtering and query optimization.
...

You can list information about the instance by running:

Code
NAME                    FQDN                                        STATE    STATUS   IMAGE                                                              MEMORY   VCPUS  ARGS                             BOOT TIME
mcp-server-arxiv-l7l24  billowing-breeze-nuusy7l2.fra.unikraft.app  standby  standby  mcp-server-arxiv@sha256:ea1e677ccc03628a3e7d57a4cd41118e3d2a63...  2.0 GiB  1      /usr/bin/python3 /src/server.py  213.07 ms

When done, you can delete the instance with:

Code
kraft cloud instance remove mcp-server-arxiv-l7l24

Using volumes

You can use volumes for data persistence. For that you would first create a volume:

Then start the MCP server instance and mount that volume (while specifying the storage path):

Available tools

The ArXiv MCP Server provides the following tools:

• search_papers: Query arXiv papers with filters for date ranges and categories
• download_paper: Download a paper by its arXiv ID
• list_papers: View all downloaded papers
• read_paper: Access the content of a downloaded paper

Learn more

• ArXiv MCP Server Documentation
• FastMCP documentation
• Model Context Protocol
• Unikraft Cloud Documentation
• Building Dockerfile Images with Buildkit

Use the --help option for detailed information on using Unikraft Cloud:

Or visit the CLI Reference or the legacy CLI Reference.