PaperGraph MCP

MCP-сервер раскладывает статьи по математике из arXiv, LaTeX и PDF на теоремы, доказательства и зависимости с опорой на источник

  • 278 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Ходит в Crossref, OpenAlex и arXiv за метаданными и открытыми PDF
  • Пишет локальную базу SQLite с заметками, очередями и импортированными статьями
Все причины и проверки

lotchuazzz-crypto/papergraph-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/papergraph-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Ходит в Crossref, OpenAlex и arXiv за метаданными и открытыми PDF
  • Пишет локальную базу SQLite с заметками, очередями и импортированными статьями

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

PaperGraph MCP превращает статью из arXiv, локальный проект LaTeX или PDF с текстовым слоем в рабочую область, построенную вокруг теорем. Агент открывает карту статьи: структуру, кандидатов в главные результаты и места, где чтение упирается во внешние работы. Затем он выбирает результат и смотрит его формулировку, доказательство, фрагменты источника и зависимости. Зависимости прослеживаются прямые и рекурсивные, с общими предпосылками, циклами и неизвестными местами. Сервер ничего не домысливает. Пустой список зависимостей еще ничего не доказывает про независимость. Порядок чтения нельзя считать полным графом. Для внешних ссылок строятся планы импорта; кандидатов ищут в Crossref, OpenAlex и arXiv, а загрузка происходит только после явного выбора. Очереди, сессии, контрольные точки, заметки и открытые вопросы хранятся в локальной базе SQLite вне репозитория. Результат экспортируется в Markdown: отчет по одной статье или план чтения по нескольким связанным статьям. Те же функции доступны из командной строки без MCP-клиента.

Для кого. Для математиков, аспирантов и исследователей, которые читают сложные статьи с помощью ИИ-агента и хотят, чтобы каждое утверждение вело к строке источника.

Подходит, если

  • Нужно понять структуру новой статьи по математике и выбрать, с какого результата начинать
  • Надо проследить, на какие леммы опирается теорема и где доказательство ссылается на внешнюю работу
  • Чтение растянулось на несколько сессий, и нужны очереди, контрольные точки и заметки
  • По списку связанных статей нужен единый план чтения в Markdown
  • По DOI требуется найти открытый полный текст, ничего не скачивая автоматически

Не подходит, если

  • Нужна проверка правильности доказательств: сервер не верифицирует доказательства и не выводит скрытые предпосылки
  • Статья сканирована без текстового слоя: поддерживаются PDF, созданные цифровым способом
  • Нужны платные тексты: обхода пейволлов нет, метаданные не равны полному тексту
  • Нужна полная карта зависимостей всей работы: автоматическое доказательство покрывает только первую строку с явным заголовком доказательства в PDF

Пример запроса к агенту

Загрузи статью arXiv 2301.00001, покажи карту статьи и выбери главный результат; затем разбери его доказательство и зависимости

MCP

Транспорт
stdio
Авторизация
не нужна

Ограничения

Сервер не подтверждает доказательства, не выводит скрытые предпосылки и не устанавливает смысловую эквивалентность теорем. У длинных PDF автоматическое доказательство покрывает только первую физическую строку с явным заголовком доказательства, принадлежность может остаться неизвестной. Внешние ссылки превращаются в планы, которые нужно просмотреть, загрузки сами не запускаются. Рабочая область локальная; перед обновлением схемы базы сделайте копию, старые версии не откроют схему 9. Нужны Python 3.10 или новее и uv. Сетевые запросы идут к сервисам Crossref, OpenAlex и arXiv.

Как отключить. Удалите блок `papergraph` из конфигурации MCP-клиента и перезапустите клиент. Рабочие области лежат в базах SQLite, которые вы создавали вне репозитория, удалите их при необходимости.

Частые вопросы

Как подключить PaperGraph MCP к Claude Code или Codex?

Добавьте в конфигурацию MCP stdio-сервер с командой `uvx` и аргументами `--from papergraph-mcp==1.2.3 papergraph-mcp`, затем перезапустите клиент. Рецепты для Codex и Claude лежат в `client-configuration.md`; на реальных клиентах автор их пока не проверял.

Почему сервер после запуска молчит?

Без параметров он ждет stdio-соединения MCP и ничего не печатает. Для проверки установки есть `papergraph-mcp doctor` и `papergraph-mcp --version`.

Что такое Paper Map?

Это первый экран работы со статьей: структура, кандидаты в главные результаты и места, где чтение упирается во внешние работы. Он нужен, чтобы выбрать теорему до того, как читать доказательство.

Как найти полный текст статьи по DOI?

Команда `discover-doi DOI` ищет кандидатов, ничего не скачивая. `add-doi-paper WORKSPACE DOI` импортирует корневую статью, если найден ровно один подходящий открытый PDF; при нескольких кандидатах нужен ваш выбор.

Где хранятся заметки и очереди чтения?

В локальных рабочих областях SQLite. Базу рекомендуют держать вне репозитория проекта, команда `plan-starter-project` заранее показывает, что будет создано, и ничего не записывает.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Локальный MCP-сервер GraphRAG: строит граф знаний из документов и отвечает с цитатами источников через Ollama.

MCP-серверРасширенный доступ327Звезды репозитория

pwc CLI

pwc-cli

Официальный

CLI, скилл и MCP-сервер Hugging Face: агент ищет статьи, бенчмарки и лучшие модели в Papers with Code без аккаунта и ключа

CLIРасширенный доступ217Звезды репозитория

Graphiti MCP

Graphiti MCP Server

MCP-сервер Graphiti от Zep: долгая память агента в виде графа знаний с учетом времени на FalkorDB или Neo4j

MCP-серверРасширенный доступ32,8 тыс.Звезды репозитория

MCP-сервер и файловая система для markdown: агент пишет заметки, а люди читают те же файлы в веб-интерфейсе с git-историей

MCP-серверРасширенный доступ877Звезды репозитория

Универсальный CLI-клиент MCP от Apify: постоянные сессии, OAuth, JSON-вывод для скриптов и доступ агента к любому MCP-серверу через оболочку

CLIШирокий доступ1,1 тыс.Звезды репозитория

Локальный MCP-сервер, который ведет журнал рассуждений агента по стадиям с сохранением сессий, решений и обоснований

MCP-серверРасширенный доступ963Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
PaperGraph MCP (эта карточка)нетне нужна278
arxiv-mcp-serverнетне нужна3 276поиск и чтение статей arXiv по разделам, без разбора теорем и зависимостей
Paper Search MCPнетключ необязателен3 076поиск и загрузка статей из arXiv, PubMed, bioRxiv и других источников

Коротко о README

README начинается с пользы: читать математику с опорой на источник. Затем идут быстрый запуск через uvx, конфигурация MCP, первый разбор статьи с командами, границы доказательной базы и ссылки на документацию с примерами отчетов и планов чтения.

Бейдж для README

Сообщить о проблеме