openalex-mcp

MCP stdio сервер для OpenAlex API (глобальный научный граф).

Данные через OpenAlex, OurResearch.

Установка

Плоская структура, соответствующая тому, как развёрнут сервер: server.py и ledger.py рядом друг с другом, запускаются по пути.

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

Затем укажите Claude Desktop на python server.py (см. ниже).

Related MCP server: Crossref Academic MCP Server

Инструменты

Конфигурация

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

Квитанции запросов

Каждый запрос может быть помещён в журнал JSONL с хеш-цепочкой, доступный только для добавления, с помощью openalex_mcp.ledger. Он выключен, если не задан MCP_RECEIPT_LOG, и сбой журналирования подавляется, а не возбуждается — поиск важнее, чем запись о нём. Секреты вымарываются до составления строки.

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

Проверьте хеш-цепочку сохранённого журнала:

python ledger.py verify receipts.jsonl

Совместимость с MCP SDK

Работает как на mcp 1.x, так и 2.x. Версия 2.0.0 SDK удалила mcp.server.fastmcp; этот сервер импортирует FastMCP, где он существует, и возвращается к MCPServer, где его нет.

Лицензия

MIT © 2026 Christopher Gerteis. Распространяется только на код сервера; он не даёт никаких прав на данные OpenAlex, OurResearch, которые остаются подчинёнными условиям этого провайдера.

Автор

Dr Christopher Gerteis, SOAS University of London.