openalex-mcp

OpenAlex API(글로벌 학술 그래프)용 MCP stdio 서버.

데이터는 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"
      }
    }
  }
}

쿼리 영수증

모든 쿼리는 openalex_mcp.ledger에 의해 추가 전용, 해시 체인 JSONL 로그에 저장될 수 있습니다. 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 모두에서 실행됩니다. SDK 2.0.0 버전은 mcp.server.fastmcp를 제거했습니다; 이 서버는 FastMCP가 존재하는 곳에서는 가져오고, 존재하지 않는 곳에서는 MCPServer로 대체합니다.

라이선스

MIT © 2026 Christopher Gerteis. 서버 코드만 다룹니다; OpenAlex, OurResearch 데이터에 대한 권한을 부여하지 않으며, 해당 데이터는 해당 제공업체의 약관에 따라 관리됩니다.

저자

Dr Christopher Gerteis, SOAS University of London.