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 が設定されない限りオフ であり、ログ記録の失敗は例外として送出されずに握りつぶされます——検索自体がその記録よりも重要だからです。1行が組み立てられる前に、秘密情報はマスクされます。

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。