arxiv-mcp-server MCP工具

Install with test dependencies (development only — no global executable)

uv pip install -e ".[test]" ```

Installing via Smithery

To install ArXiv Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install arxiv-mcp-server --client claude

Installing via Claude Desktop (.mcpb)

The .mcpb bundle is the one-click install path for Claude Desktop on macOS. It bundles the server code and Python package dependencies, so users do not need uv, pip, or manual MCP JSON configuration. Python 3.11+ must still be available on the user's machine.

1. Download the artifact matching your Mac from the latest release: - Apple Silicon: arxiv-mcp-server-darwin-arm64-<version>.mcpb - Intel: arxiv-mcp-server-darwin-x86_64-<version>.mcpb 2. In Claude Desktop open Settings → Extensions (or drag-and-drop the file onto the Claude Desktop window). 3. Click Install and, when prompted, set your preferred paper storage directory (defaults to ~/.arxiv-mcp-server/papers).

Claude Desktop launches the bundled server over stdio — no configuration file edits needed.

Installing Manually

Important — use uv tool install, not npm/pnpm or uv pip install This project publishes the supported server as a Python package on PyPI. Do not install arxiv-mcp-server with npm install, pnpm add, or npx arxiv-mcp-server: the npm package with this name is an unrelated third-party package and has its own Python-detection wrapper. Running uv pip install arxiv-mcp-server installs the package into the current virtual environment but does not place the arxiv-mcp-server executable on your PATH. You must use uv tool install so that uv creates an isolated environment and exposes the executable globally:

uv tool install arxiv-mcp-server

After this, the arxiv-mcp-server command will be available on your PATH.

PDF fallback (older papers): Most arXiv papers have an HTML version which the base install handles automatically. For older papers that only have a PDF, the server needs the [pdf] extra (pymupdf4llm). Install it with:

> uv tool install 'arxiv-mcp-server[pdf]'
> 

You can verify it with:

arxiv-mcp-server --help

If you previously ran uv pip install arxiv-mcp-server and the command is missing, uninstall it and re-install with uv tool install as shown above.

For development:

```bash

🚀 Quick Start

Clone and set up development environment

git clone https://github.com/blazickjp/arxiv-mcp-server.git cd arxiv-mcp-server

Create and activate virtual environment

uv venv source .venv/bin/activate

⚙️ Configuration

Configure through command-line options and environment variables:

References

• OWASP LLM01: Prompt Injection
• OWASP Agentic AI - AG01: Prompt Injection

---

🤖 Codex Plugin Integration

This repository now includes a Codex plugin manifest at .codex-plugin/plugin.json and a portable MCP config at .mcp.json so Codex-oriented tooling can discover the server without inventing its own install recipe.

The Codex integration uses the same stdio launch path documented elsewhere in this README:

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

If your Codex client supports plugin manifests, point it at ./.codex-plugin/plugin.json. If it only supports raw MCP configuration, use ./.mcp.json directly.

🔌 MCP Integration

Add this configuration to your MCP client config file:

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

For Development:

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/arxiv-mcp-server",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

Core Workflow

The typical workflow for deep paper research is:

search_papers → download_paper → read_paper

list_papers shows what you have locally. semantic_search searches across your local collection.

---