openalex-mcp

MCP-stdio-Server für die OpenAlex-API (globaler wissenschaftlicher Graph).

Daten über OpenAlex, OurResearch.

Installation

Flaches Layout, passend zur Bereitstellung des Servers: server.py und ledger.py nebeneinander, per Pfad ausgeführt.

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

Richten Sie dann Claude Desktop auf python server.py (siehe unten).

Related MCP server: Crossref Academic MCP Server

Werkzeuge

Konfiguration

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"
      }
    }
  }
}

Abfragebelege

Jede Abfrage kann in ein append-only, hash-verkettetes JSONL-Protokoll durch openalex_mcp.ledger abgelegt werden. Es ist aus, außer MCP_RECEIPT_LOG ist gesetzt, und ein Protokollierungsfehler wird verschluckt statt ausgelöst — eine Suche ist wichtiger als die Aufzeichnung davon. Geheimnisse werden geschwärzt, bevor eine Zeile erstellt wird.

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

Verifizieren Sie die Hash-Kette eines abgelegten Protokolls:

python ledger.py verify receipts.jsonl

MCP SDK Kompatibilität

Läuft sowohl auf mcp 1.x als auch 2.x. Version 2.0.0 des SDK hat mcp.server.fastmcp entfernt; dieser Server importiert FastMCP, wo es existiert, und fällt auf MCPServer zurück, wo es nicht existiert.

Lizenz

MIT © 2026 Christopher Gerteis. Deckt nur den Servercode ab; es gewährt keine Rechte an OpenAlex- und OurResearch-Daten, die weiterhin den Bedingungen dieses Anbieters unterliegen.

Autor

Dr Christopher Gerteis, SOAS University of London.