Semanticscholar

@pipeworx/semanticscholar

Semantic Scholar 学术图谱：搜索 2 亿多篇论文，按 ID、DOI 或 arXiv id 查找论文，追踪论文的引用，并查询作者及其引用指标和 h 指数。

属于 Pipeworx — 一个将 AI Agent 连接到 1683 多个实时数据源的 MCP 网关。

工具

• search_papers(query, year?, limit?) — 搜索匹配查询的论文：标题、 年份、作者、期刊、引用次数、DOI、开放获取 PDF、摘要。
• get_paper(paper_id) — 按 Semantic Scholar id、DOI:… 或 arXiv:… 查询单篇论文。
• get_paper_citations(paper_id, limit?) — 引用该论文的论文。
• get_author(name) — 作者的论文和引用指标。

认证

平台密钥（PLATFORM_SEMANTICSCHOLAR_KEY）通过 x-api-key 发送。没有密钥时，公共图谱端点仍会响应，但在负载较高时会严格限流（429）。

许可 — 零费率（fleet #1974）

该密钥依据 Semantic Scholar API License Agreement (https://api.semanticscholar.org/license/) 签发。§2(a) 将使用范围限定为 "合法的、非商业性的研究和/或教育用途"，并要求 "任何对 Data 的公开使用都必须指向 Semantic Scholar，网址为 https://www.semanticscholar.org/，且带有 utm_source=api UTM 参数"；Use Restrictions 禁止向第三方 "出售、出租、分享、转让、再许可、商业化……任何通过 API 获取的 Data"。后果如下：

• 网关条目中设置 zeroRated: true：所有等级均不扣除积分，不占用 用量阶梯名额。
• 每个响应都会首先提供 attribution（指向原站）、license （LicenseRef-SemanticScholar-API-License-Agreement，kind: vendor_terms， 义务为 attribution + non_commercial）和 license_note，通过 @pipeworx/shared 中的 attachLicense 添加。
• 零费率免除费用，但不代表获准继续分享：调用方自身的使用也必须是非商业用途，说明中对此有明确提示。

数据源

• https://api.semanticscholar.org/graph/v1/paper/search — 搜索。
• https://api.semanticscholar.org/graph/v1/paper/{id} — 单篇论文及其下的 /citations。
• https://api.semanticscholar.org/graph/v1/author/search — 作者。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "semanticscholar": {
      "url": "https://gateway.pipeworx.io/semanticscholar/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/semanticscholar/mcp 上的 tools/list 会返回上表中的工具， 以及 Pipeworx 共享元工具 — ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关全局工具集中的其他工具。因此，你看到的工具数量会多于上表：目前，单个工具包端点除了工具包自身的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其准确范围，这是当日情况的权威信息。

这是有意为之，并非意外多路复用。元工具让限定范围的连接也能通过 ask_pipeworx 回答本工具包未涵盖的问题；它会在整个目录中进行路由，因此无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的 schema 带来的上下文成本高于路由的价值，请连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会访问同一个网关和相同的 1683 多个数据源。唯一的区别在于直接列出哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/semanticscholar_search_papers \
  -H 'Content-Type: application/json' \
  -d '{"query":"transformer attention mechanism","year":"2023","limit":10}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/semanticscholar_search_papers。查找工具包：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行，无需 Pipeworx 账户，也无需经过网关往返：

{
  "mcpServers": {
    "semanticscholar": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-semanticscholar"]
    }
  }
}

也可以直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-semanticscholar

它通过 stdin/stdout 使用 MCP 通信，并针对仅限此软件包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的任何共享元工具。相同的源代码，相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗的英语提问，而不是直接调用工具——这既适用于上方的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Semanticscholar data" })

网关会选择合适的工具并自动填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT