# arxiv-search-mcp

An MCP server for searching arXiv.

## Installation

Install the package directly with PyPI.

```bash
pip install arxiv-search-mcp
```

Once installed in your agent's environment, you can load it with the settings in
[`sample_settings.json`](./sample_settings.json).

## Usage

Once installed, you can run the server module directly.

```bash
python -m arxiv_search_mcp
```

To run the server using the MCP inspector, execute the following command.

```bash
uv run mcp dev arxiv_search_mcp/mcp_server.py
```

To include the server in your agent config, ensure it's installed in the agent's
virtualenv and then add this to your config.

```json
{
  "mcpServers": {
    "arxiv": {
      "command": "python",
      "args": ["-m", "arxiv_mcp"]
    }
  }
}
```

## Tools

The following tools are available:

### `search_papers`

Search for papers on arXiv.

**Parameters:**

*   `query` (str): The search query.
*   `max_results` (int, optional): The maximum number of results to return. Defaults to 10.

### `get_paper`

Get detailed information about a specific paper.

**Parameters:**

*   `paper_id` (str): The ID of the paper to retrieve.