← 返回目录

OpenAlex MCP Server

社区

通过 MCP 访问 OpenAlex 学术研究目录——超过 2.7 亿篇出版物。支持 STDIO 和 Streamable HTTP。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 16 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js · Bun 1.3.0+ · Docker · 远程托管（无需本地环境）
凭据: 可选 API Key
许可证: Apache-2.0
最近提交: 6 天前
工具数: 5

63FMRS · C

OpenAlex MCP 服务器提供了对大型学术知识库的结构化访问，可供发现、趋势分析和引文图遍历。它对于将学术数据集成到 AI 助手工作流中非常有用。

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

14/20

维护活跃度

10/20

文档质量

15/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: README 详细描述了5个工具、错误映射(400→InvalidParams等)、重试与AbortSignal取消，语义清晰、行为边界说明细致；但静态审查无执行证据，未提供实际CI工作流或测试文件内容，无法验证握手与工具行为一致性。错误处理设计合理但未经证实，扣分至10。
安全与权限 14/20: 无红线风险：无恶意行为、无硬编码凭据、API密钥通过环境变量可选提供、HTTP默认绑定127.0.0.1、有Origin允许列表概念。但认证默认none、上游公网请求(OpenAlex)默认配置、MCP_ALLOWED_ORIGINS可设为*，权限确认与数据流披露部分完整，扣至14。
维护活跃度 10/20: 版本0.7.10且持续迭代(README badge显示0.7.8，manifest为0.7.10，说明有更新)、Apache-2.0许可证、非归档、6个开放issue；但无安全响应渠道、无治理信息、维护者身份与发布节奏仅能从manifest推断，扣至10。
文档质量 15/20: README分层清晰：工具表、参数细节、配置变量表、Docker与本地运行、成本/预算披露(每日配额报告)与限制说明(nullable display_name、related_to可能为空)，质量较高；但缺少故障排查章节，部分行为宣称(预算追踪)无独立证据，扣至15。
安装易用性 14/20: 提供公共托管实例、npm包、npx一行配置及Claude Desktop/Cursor/VS Code deeplink安装徽章，配置默认值合理，安装路径清晰；但运行时需Node/npx且声明Bun开发依赖，manifest与README版本号不一致(0.7.10 vs 0.7.8)略增摩擦，扣至14。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

研究人员、图书馆员和学术写作助手。
需要最新学术元数据的开发人员。
希望在大型学术知识库之上构建 AI 工具的人。

不适合谁

需要全文 PDF 访问——服务器仅提供元数据。
只需要日常非学术搜索的用户。
对 OpenAlex 数据的实时性要求极高，可能无法满足。

所需权限

需要访问 OpenAlex API，可匿名或使用 API 密钥。
对于 HTTP 传输，需要在本地开放端口或配置公网端点。
需从可能包含名称的输入数据中读取或解析。

风险与副作用

如果使用匿名访问，API 速率限制可能较高；若没有正确设置邮件标识，请求可能被限流。
OpenAlex 数据虽有更新，但可能不是实时的，且可能存在未收录的记录。
如果通过互联网暴露，服务器可能成为滥用目标；建议保护端点。
工具返回大量数据可能导致较大的网络传输和内存使用。

安装接入

准备工作

运行环境：Node.js · Bun 1.3.0+ · Docker · 远程托管（无需本地环境）

OPENALEX_API_KEY 可选密钥可选的 OpenAlex 账户 API 密钥，可从 https://openalex.org/settings/api 免费获取；不设置则使用匿名速率限制。

其他可选配置项（11 个）

OPENALEX_MAILTO 可选可选的邮箱地址，以 mailto= 发送给 OpenAlex 以进入礼貌池，与 API 密钥相互独立。

OPENALEX_BASE_URL 可选 OpenAlex API 的基础 URL，默认 https://api.openalex.org，一般无需修改。

MCP_TRANSPORT_TYPE 可选传输方式，可选 stdio 或 http，默认 stdio。

MCP_HTTP_HOST 可选 HTTP 服务器监听的主机名，默认 127.0.0.1。

MCP_HTTP_PORT 可选 HTTP 服务器端口，默认 3010。

MCP_HTTP_ENDPOINT_PATH 可选 MCP 服务的 HTTP 端点路径，默认 /mcp。

MCP_AUTH_MODE 可选 HTTP 认证模式，可选 none、jwt 或 oauth，默认 none。

MCP_ALLOWED_ORIGINS 可选 HTTP 传输允许的浏览器 Origin 白名单，逗号分隔；不设置则仅允许本地回环。

MCP_LOG_LEVEL 可选日志最低级别（如 debug、info、warn），默认 info。

LOGS_DIR 可选日志文件存放目录（仅 Node.js），默认项目根目录下的 logs。

OTEL_ENABLED 可选是否启用 OpenTelemetry 插桩（跨度、指标等），默认 false。

确保已安装 Node.js（和 Bun，用于开发）。
在你的 MCP 客户端配置中添加服务器，例如在 Claude Desktop 中使用 stdio 传输：

{
  "mcpServers": {
    "openalex-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cyanheads/openalex-mcp-server"],
      "env": {
        "OPENALEX_API_KEY": "your-openalex-api-key"
      }
    }
  }
}

或者，使用公开的托管端点：https://openalex.caseyjhand.com/mcp（配置为 streamable HTTP）。
可选地设置环境变量 OPENALEX_API_KEY（从 OpenAlex 免费获取）和 OPENALEX_MAILTO（用于礼貌池）。

claude_desktop_config.json

{
  "mcpServers": {
    "openalex-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openalex-mcp-server"
      ],
      "env": {
        "OPENALEX_API_KEY": "your-openalex-api-key"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "openalex-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openalex-mcp-server"
      ],
      "env": {
        "OPENALEX_API_KEY": "your-openalex-api-key"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add openalex-mcp-server -e OPENALEX_API_KEY=your-openalex-api-key -- npx -y @cyanheads/openalex-mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

连接成功后，客户端的工具列表中应出现五个 openalex_* 工具；调用 openalex_describe_fields 查询 'works' 实体类型的字段列表，若能返回字段即证明 OpenAlex API 连接正常。

常见排障

如果查询失败并提示无效字段，请先调用 `openalex_describe_fields` 验证字段名称。
如果收到 429 速率限制，请等待或设置 `OPENALEX_API_KEY` 和 `OPENALEX_MAILTO` 以提高限制。
如果 HTTP 连接失败，请检查主机和端口配置，以及身份验证模式是否匹配。
如果看到无效认证错误，请检查 `OPENALEX_API_KEY` 是否正确。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索 2022 到 2024 年间关于 CRISPR 基因编辑的论文，显示标题、发表年份和 DOI。
按年份统计免疫学领域开放获取论文的发表趋势。
把 DOI 10.1038/s41586-020-2649-2 解析为 OpenAlex ID，然后列出引用它的文献。
authors 实体类型有哪些有效的过滤字段名？

工具能力 5

openalex_search_entities 只读

跨所有 8 种实体类型进行搜索、过滤、排序或按 ID 检索（作品、作者、来源、机构、主题、关键词、出版商、资助者）。

openalex_analyze_trends 只读

分组聚合，用于趋势和分布分析，例如按出版年份或开放获取状态统计出版物数量。

openalex_resolve_name 只读

将名称或标识符（如 DOI、ORCID、ROR、PMID、PMCID、ISSN、OpenAlex ID）解析为 OpenAlex ID。

openalex_get_citation_graph 只读

从种子作品出发，单跳遍历引用图：引用它的、它引用的或相关的作品。

openalex_describe_fields 只读

列出某实体类型有效的 filter、group_by 和 select 字段名称，在构建查询前调用以避免无效字段错误。

使用场景

让 AI 助手进行学术文献搜索并回答关于特定主题的问题。

自动化系统性文献综述，包括查询构建、筛选和引用网络分析。

分析特定领域的研究格局，包括数量趋势、顶尖作者和机构。

在应用程序中集成学术元数据和引文数据。

支持客户端

Claude Desktop

Cursor

VS Code

依据项目文档列出，未经本站实测。

详细介绍

OpenAlex MCP 服务器是一个社区开发的服务器，它使 AI 助手能够查询 OpenAlex 学术目录，该目录包含超过 2.7 亿篇出版物。它提供了五个用于搜索、过滤和聚合学术数据的工具，以及两个用于文献综述和研究格局分析的提示。它可以作为本地 stdio 服务器或 HTTP 服务器运行，并可通过 Docker 部署。