Metadata-Version: 2.4
Name: arxiv-search-mcp
Version: 0.2.0
Summary: Simple MCP server for searching arXiv
Author-email: Mark McDonald <i@ii.net>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/markmcd/arxiv-search-mcp
Project-URL: Issues, https://github.com/markmcd/arxiv-search-mcp/issues
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: arxiv
Requires-Dist: mcp[cli]
Dynamic: license-file

# 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.

