arXiv MCP for Cursor

Small MCP server in Python that connects Cursor (or any MCP client) to the public arXiv API — no API key required.

Cursor → MCP → arXiv MCP Server → arXiv API

• GitHub: https://github.com/easimawen/mcp-arxiv
• PyPI: https://pypi.org/project/mcp-arxiv/ (after the first publish)

The PyPI name arxiv-mcp is already taken by another project. This package is published as mcp-arxiv.

Tools

Design docs: RFC-0001 · architecture

Requirements

• Python 3.14+
• uv (recommended)

Quick usage (after PyPI publish)

{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": ["mcp-arxiv"]
    }
  }
}

Install from the repository

git clone https://github.com/easimawen/mcp-arxiv.git
cd mcp-arxiv
uv sync

Cursor MCP config (use the absolute path to your clone):

{
  "mcpServers": {
    "arxiv": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/mcp-arxiv", "run", "mcp-arxiv"]
    }
  }
}

CLI smoke test

uv run python -c "
import asyncio
from arxiv_mcp.arxiv_client import ArxivClient

async def main():
    async with ArxivClient() as c:
        p = await c.get_paper('2510.16079')
        print(p.title, p.url)

asyncio.run(main())
"

Development

uv sync --group dev
uv run pytest
uv run mcp-arxiv

Publish (maintainers)

1. Create a PyPI account if needed.
2. Add a pending trusted publisher: PyPI → Publishing
   • Owner: easimawen
   • Repository: mcp-arxiv
   • Workflow: publish.yml
   • Environment: pypi
   • Project name: mcp-arxiv
3. On GitHub: Settings → Environments → create pypi (optional: require reviewers).
4. Commit + push, then create a GitHub Release v0.1.0 (tag v0.1.0).
5. The workflow .github/workflows/publish.yml publishes via OIDC (no long-lived token).

Local build check:

uv build
# manual publish (fallback):
# export UV_PUBLISH_TOKEN=pypi-...
# uv publish

See also docs/publishing.md.

License

MIT — see LICENSE.