# arxiv-mcp-server

Ищет статьи на arXiv, возвращает метаданные и читает полный текст. Пригодится агенту для поиска научных работ и разбора публикаций.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Автор: cyanheads
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cyanheads/arxiv-mcp-server
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/cyanheads-arxiv-mcp-server

## Что делает

arxiv-mcp-server подключает arXiv к агенту через MCP. Сервер умеет искать статьи по запросу, категории и датам, получать метаданные по идентификаторам и читать полный текст. Отдельный инструмент показывает категории arXiv. Доступны также два ресурса: метаданные статьи и дерево категорий.

Подключение работает через удалённый HTTP-сервер или локальный процесс `npx`. Для поиска поддерживаются префиксы полей вроде `ti:`, `au:` и `cat:`, логические операторы `AND`, `OR`, `ANDNOT`, а также сортировка по релевантности, дате отправки или обновления. При чтении сервер перебирает HTML, ar5iv и извлечение текста из PDF.

Из PDF математика, таблицы и заголовки превращаются в плоский текст, поэтому для таких фрагментов лучше использовать HTML-версию статьи.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://arxiv.caseyjhand.com/mcp`
- Переменные окружения: `ARXIV_API_BASE_URL`, `ARXIV_REQUEST_DELAY_MS`, `ARXIV_CONTENT_TIMEOUT_MS`, `ARXIV_API_TIMEOUT_MS`, `ARXIV_READ_TIMEOUT_MS`, `MCP_LOG_LEVEL`, `MCP_TRANSPORT_TYPE`, `MCP_HTTP_HOST`, `MCP_HTTP_PORT`, `MCP_HTTP_ENDPOINT_PATH` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http arxiv-mcp-server https://arxiv.caseyjhand.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env ARXIV_API_BASE_URL=<ARXIV_API_BASE_URL> --env ARXIV_REQUEST_DELAY_MS=<ARXIV_REQUEST_DELAY_MS> --env ARXIV_CONTENT_TIMEOUT_MS=<ARXIV_CONTENT_TIMEOUT_MS> --env ARXIV_API_TIMEOUT_MS=<ARXIV_API_TIMEOUT_MS> --env ARXIV_READ_TIMEOUT_MS=<ARXIV_READ_TIMEOUT_MS> --transport stdio cyanheads-arxiv-mcp-server -- npx -y @cyanheads/arxiv-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add cyanheads-arxiv-mcp-server --url https://arxiv.caseyjhand.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add cyanheads-arxiv-mcp-server --env ARXIV_API_BASE_URL=<ARXIV_API_BASE_URL> --env ARXIV_REQUEST_DELAY_MS=<ARXIV_REQUEST_DELAY_MS> --env ARXIV_CONTENT_TIMEOUT_MS=<ARXIV_CONTENT_TIMEOUT_MS> --env ARXIV_API_TIMEOUT_MS=<ARXIV_API_TIMEOUT_MS> --env ARXIV_READ_TIMEOUT_MS=<ARXIV_READ_TIMEOUT_MS> -- npx -y @cyanheads/arxiv-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cyanheads-arxiv-mcp-server": {
            "url": "https://arxiv.caseyjhand.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cyanheads-arxiv-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@cyanheads/arxiv-mcp-server"
            ],
            "env": {
                "ARXIV_API_BASE_URL": "<ARXIV_API_BASE_URL>",
                "ARXIV_REQUEST_DELAY_MS": "<ARXIV_REQUEST_DELAY_MS>",
                "ARXIV_CONTENT_TIMEOUT_MS": "<ARXIV_CONTENT_TIMEOUT_MS>",
                "ARXIV_API_TIMEOUT_MS": "<ARXIV_API_TIMEOUT_MS>",
                "ARXIV_READ_TIMEOUT_MS": "<ARXIV_READ_TIMEOUT_MS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "cyanheads-arxiv-mcp-server": {
            "type": "http",
            "url": "https://arxiv.caseyjhand.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "cyanheads-arxiv-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@cyanheads/arxiv-mcp-server"
            ],
            "env": {
                "ARXIV_API_BASE_URL": "<ARXIV_API_BASE_URL>",
                "ARXIV_REQUEST_DELAY_MS": "<ARXIV_REQUEST_DELAY_MS>",
                "ARXIV_CONTENT_TIMEOUT_MS": "<ARXIV_CONTENT_TIMEOUT_MS>",
                "ARXIV_API_TIMEOUT_MS": "<ARXIV_API_TIMEOUT_MS>",
                "ARXIV_READ_TIMEOUT_MS": "<ARXIV_READ_TIMEOUT_MS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http cyanheads-arxiv-mcp-server https://arxiv.caseyjhand.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e ARXIV_API_BASE_URL=<ARXIV_API_BASE_URL> -e ARXIV_REQUEST_DELAY_MS=<ARXIV_REQUEST_DELAY_MS> -e ARXIV_CONTENT_TIMEOUT_MS=<ARXIV_CONTENT_TIMEOUT_MS> -e ARXIV_API_TIMEOUT_MS=<ARXIV_API_TIMEOUT_MS> -e ARXIV_READ_TIMEOUT_MS=<ARXIV_READ_TIMEOUT_MS> cyanheads-arxiv-mcp-server npx -y @cyanheads/arxiv-mcp-server
```
Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера

## Когда брать
- найти статьи по теме, автору или категории
- получить метаданные по одному или нескольким arXiv ID
- прочитать полный текст публикации
- вывести категории arXiv для фильтрации поиска

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md