mcp-refchecker

Un servidor MCP que permite a Claude verificar citas académicas en tiempo real frente a Semantic Scholar, OpenAlex y Crossref, detectando referencias alucinadas o incorrectas antes de que terminen en tu trabajo.

Construido sobre academic-refchecker (MIT).

Herramienta

verify_citation — verifica que un artículo citado exista y que sus metadatos (título, autores, año, lugar de publicación) coincidan con lo citado.

Devuelve JSON:

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

Campos de resultado

• verified — true si se encontró el artículo y todos los metadatos proporcionados (año, autores, lugar) coinciden. false si hay un conflicto real de metadatos o si no se pudo encontrar el artículo.

• matched_paper — los metadatos autorizados de la fuente de verificación.

• possible_match — una coincidencia de respaldo de Crossref cuando no se encontró el título exacto pero sí una variante cercana (ver "Respaldo difuso" a continuación).

• errors — errores graves que bloquean la verificación (año incorrecto, autores incorrectos, artículo no encontrado).

• warnings — advertencias leves que no bloquean la verificación (diferencias entre arXiv v1 y v2, diferencias entre preimpresión de arXiv y lugar de publicación, metadatos de entrada incompletos).

• info — sugerencias informativas (ej., "la referencia podría incluir la URL de arXiv").

Qué cuenta como error frente a una advertencia

academic-refchecker devuelve una lista plana de problemas con cierta inconsistencia (las discrepancias de año se marcan como advertencias, mientras que las discrepancias de autor se marcan como errores). Este envoltorio normaliza la salida:

• Promovidos a errores graves: discrepancias simples de year/author/venue donde los metadatos citados realmente difieren de la realidad. Estos bloquean verified.

• Degradados a advertencias: errores de "campo faltante" cuando se encontró el artículo pero el usuario no proporcionó ese campo en primer lugar. La falta de metadatos de entrada no es evidencia de una cita alucinada.

• Mantenidos como advertencias: diferencias de versión de arXiv (v1 vs v2), notas sobre lugar de publicación de preimpresión frente a publicado.

Respaldo difuso y sus limitaciones

Cuando academic-refchecker informa que un artículo no pudo ser verificado, este envoltorio realiza una consulta secundaria a Crossref utilizando coincidencia de títulos difusa y fuzzywuzzy.ratio. Si se encuentra un candidato con una similitud ≥ 85%, se devuelve como possible_match con una advertencia.

Lo que detecta el respaldo difuso:

• Variaciones estilísticas de títulos (diferencias de mayúsculas, puntuación, orden de palabras)

• Reformulaciones menores

• Títulos donde la comparación estricta de refchecker rechazó una coincidencia por lo demás válida

Lo que NO detecta el respaldo difuso:

• Errores tipográficos reales en palabras distintivas del título (ej., "Atention Is All You Need")

• Títulos gravemente alterados

Esta es una limitación fundamental de las APIs de búsqueda académica gratuitas. Crossref, OpenAlex y Semantic Scholar realizan búsquedas basadas en palabras clave/tokens; tan pronto como una palabra distintiva está mal escrita, simplemente no está en el índice de búsqueda y el artículo real no aparecerá en los resultados, independientemente de cómo los proceses posteriormente. Detectar errores tipográficos reales requeriría incrustaciones semánticas de una API de pago (OpenAI, Voyage, etc.) o un motor de búsqueda difusa de texto completo, ninguno de los cuales está expuesto por fuentes de datos académicos gratuitas.

Si sospechas que hay un error tipográfico pero verify_citation devuelve "no verificado", la mejor solución es reescribir el título de la forma más canónica posible e intentarlo de nuevo.

Related MCP server: Lyra's Expanded Research MCP

Instalación y configuración

Recomendado: uvx (sin paso de instalación)

Si tienes instalado uv, no se necesita una instalación por separado. Añádelo directamente a tu claude_desktop_config.json:

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

uvx descarga y ejecuta el paquete en un entorno aislado automáticamente. Reinicia Claude Desktop después de guardar la configuración.

Alternativa: pip

pip install mcp-refchecker

Luego añade a claude_desktop_config.json:

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

Desde el código fuente

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

Variables de entorno opcionales

• SEMANTIC_SCHOLAR_API_KEY — solicita una aquí para obtener límites de tasa más altos en la ruta de verificación principal de refchecker.

• CROSSREF_MAILTO — tu correo electrónico de contacto, utilizado para optar por el polite pool de Crossref para un acceso de respaldo difuso más fiable.

• MCP_REFCHECKER_DEBUG — establécelo en cualquier valor no vacío para imprimir el registro de depuración de la ruta de respaldo difuso en stderr.

Ejemplo con todas las configuraciones opcionales (uvx):

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

Licencia

MIT — © Jonas Bååth. Construido sobre academic-refchecker (MIT).