mcp-refchecker

MCP-сервер, который позволяет Claude проверять академические цитирования в режиме реального времени через Semantic Scholar, OpenAlex и Crossref — выявляя галлюцинации или неверные ссылки до того, как они попадут в вашу работу.

Построен на базе academic-refchecker (MIT).

Инструмент

verify_citation — проверяет, существует ли цитируемая статья и совпадают ли её метаданные (название, авторы, год, место публикации) с указанными.

Возвращает JSON:

{
  "verified": true,
  "url": "https://...",
  "matched_paper": {
    "title": "...",
    "authors": [...],
    "year": 2023,
    "venue": "..."
  },
  "possible_match": null,
  "errors": null,
  "warnings": null,
  "info": null
}

Поля результата

• verified — true, если статья найдена и все предоставленные метаданные (год, авторы, место публикации) совпадают. false, если есть реальное несоответствие метаданных или статью не удалось найти.

• matched_paper — достоверные метаданные из источника проверки.

• possible_match — вариант соответствия из Crossref, если точное название не было найдено, но был найден близкий вариант (см. «Нечеткий поиск» ниже).

• errors — критические ошибки, блокирующие проверку (неверный год, неверные авторы, статья не найдена).

• warnings — предупреждения, не блокирующие проверку (различия между v1 и v2 в arXiv, различия между препринтом arXiv и опубликованной версией, неполные входные метаданные).

• info — информационные предложения (например, «ссылка может включать URL arXiv»).

Что считается ошибкой, а что — предупреждением

academic-refchecker возвращает плоский список проблем с некоторой непоследовательностью (несовпадения года помечаются как предупреждения, в то время как несовпадения авторов — как ошибки). Эта обертка нормализует вывод:

• Повышены до критических ошибок: явные несовпадения year/author/venue, где цитируемые метаданные действительно отличаются от реальности. Они блокируют verified.

• Понижены до предупреждений: ошибки «отсутствующее поле», когда статья найдена, но пользователь изначально не предоставил это поле. Отсутствие входных метаданных не является доказательством галлюцинации цитирования.

• Оставлены как предупреждения: различия версий arXiv (v1 vs v2), примечания о различии препринта и опубликованной версии.

Нечеткий поиск и его ограничения

Когда academic-refchecker сообщает, что статью не удалось проверить, эта обертка делает вторичный запрос к Crossref, используя нечеткое сравнение названий и fuzzywuzzy.ratio. Если найден кандидат со сходством ≥ 85%, он возвращается как possible_match с предупреждением.

Что ловит нечеткий поиск:

• Стилистические вариации названий (различия в регистре, пунктуации, порядке слов)

• Незначительные изменения формулировок

• Названия, которые строгое сравнение refchecker отклонило, несмотря на валидность

Что НЕ ловит нечеткий поиск:

• Реальные опечатки в ключевых словах названия (например, «Atention Is All You Need»)

• Сильно искаженные названия

Это фундаментальное ограничение бесплатных академических поисковых API. Crossref, OpenAlex и Semantic Scholar используют поиск по ключевым словам/токенам — как только ключевое слово написано с ошибкой, его просто нет в поисковом индексе, и реальная статья не появится в результатах, независимо от того, как вы обрабатываете их после. Для обнаружения реальных опечаток потребовались бы семантические эмбеддинги из платного API (OpenAI, Voyage и т.д.) или полнотекстовый поисковый движок с нечетким поиском, ни один из которых не предоставляется бесплатными научными источниками данных.

Если вы подозреваете опечатку, но verify_citation возвращает результат «не проверено», лучший способ — переписать название в максимально канонической форме и попробовать снова.

Related MCP server: Lyra's Expanded Research MCP

Установка и настройка

Рекомендуется: uvx (без этапа установки)

Если у вас установлен uv, отдельная установка не требуется. Добавьте напрямую в ваш claude_desktop_config.json:

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

uvx автоматически загружает и запускает пакет в изолированной среде. Перезапустите Claude Desktop после сохранения конфигурации.

Альтернатива: pip

pip install mcp-refchecker

Затем добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "refchecker": {
      "command": "mcp-refchecker"
    }
  }
}

Из исходного кода

git clone https://github.com/JonasBaath/mcp-refchecker
cd mcp-refchecker
pip install .

Дополнительные переменные окружения

• SEMANTIC_SCHOLAR_API_KEY — запросите ключ здесь для повышения лимитов запросов на основном пути проверки refchecker.

• CROSSREF_MAILTO — ваш контактный email, используемый для присоединения к polite pool Crossref для более надежного доступа к нечеткому поиску.

• MCP_REFCHECKER_DEBUG — установите любое непустое значение для вывода отладочных логов пути нечеткого поиска в stderr.

Пример со всеми дополнительными настройками (uvx):

{
  "mcpServers": {
    "refchecker": {
      "command": "uvx",
      "args": ["mcp-refchecker"],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "your-key-here",
        "CROSSREF_MAILTO": "you@example.com"
      }
    }
  }
}

Лицензия

MIT — © Jonas Bååth. Построено на academic-refchecker (MIT).