openalex-mcp

Servidor MCP stdio para la API de OpenAlex (grafo académico global).

Datos a través de OpenAlex, OurResearch.

Instalación

Disposición plana, acorde con cómo se despliega el servidor: server.py y ledger.py uno al lado del otro, ejecutados por ruta.

python -m venv .venv && .venv/bin/pip install -e .

Luego apunta Claude Desktop a python server.py (ver más abajo).

Related MCP server: Crossref Academic MCP Server

Herramientas

Configuración

OPENALEX_API_KEY=optional_openalex_api_key
OPENALEX_EMAIL=your_email_for_the_polite_pool

Claude Desktop

{
  "mcpServers": {
    "openalex": {
      "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\openalex_mcp\\server.py"],
      "env": {
        "OPENALEX_API_KEY": "optional_openalex_api_key",
        "OPENALEX_EMAIL": "your_email_for_the_polite_pool"
      }
    }
  }
}

Recibos de consulta

Cada consulta puede depositarse en un registro JSONL de solo añadido y encadenado por hash mediante openalex_mcp.ledger. Está desactivado a menos que se establezca MCP_RECEIPT_LOG, y un fallo de registro se traga en lugar de lanzarse: una búsqueda importa más que el registro de la misma. Los secretos se redactan antes de componer una línea.

MCP_RECEIPT_LOG=C:\path\to\receipts.jsonl
MCP_RECEIPT_SESSION=project-or-article-slug
MCP_RECEIPT_STRICT=1        # optional: make logging failure raise

Verifica la cadena de hash de un registro depositado:

python ledger.py verify receipts.jsonl

Compatibilidad con el SDK de MCP

Se ejecuta tanto en mcp 1.x como en 2.x. La versión 2.0.0 del SDK eliminó mcp.server.fastmcp; este servidor importa FastMCP donde existe y recurre a MCPServer donde no.

Licencia

MIT © 2026 Christopher Gerteis. Cubre solo el código del servidor; no otorga derechos sobre los datos de OpenAlex, OurResearch, que siguen regidos por los términos de ese proveedor.

Autor

Dr Christopher Gerteis, SOAS University of London.