convez.ai
MCP ServerBusca & PesquisaIntermediário
Linductor-alkaid

Academic Search MCP

Linductor-alkaid/academic-search-mcp

Busca acadêmica specializada em robótica e RL com métricas integradas

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP especializado em busca de papers acadêmicos nas áreas de robótica e aprendizado por reforço. Integra Semantic Scholar, arXiv e OpenAlex para oferecer busca avançada por palavras-chave, autor, período temporal, além de métricas como fator de impacto, h-index e contagem de citações.

Instalação

$npx convez-ai Linductor-alkaid/academic-search-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Pesquisar papers recentes em robótica e reinforcement learning com filtros avançados
  • Consultar métricas de impacto de conferências (ICRA, NeurIPS) e periódicos
  • Analisar influência de autores e rastrear citações de trabalhos específicos
  • Coletar preprints do arXiv com busca por categorias e datas

Veredito

Ferramenta sólida e bem implementada para pesquisadores em robótica/RL. Exige setup inicial (chaves de API), mas oferece acesso integrado a múltiplas fontes de peso com funcionalidades práticas como filtros temporais e extração de métricas acadêmicas.

README

A tradução para o português deste README ainda está na fila.

academic-search-mcp

本地 stdio MCP Server,专为机器人学与强化学习(Robotics + RL)领域的论文检索而构建。支持按关键词、时间范围、作者、期刊/会议搜索,查看引用数、影响因子、h-index 等指标,获取摘要、DOI 和 PDF 链接。

数据源

API用途认证
Semantic Scholar论文搜索、详情、引用、作者可选 S2_API_KEY
arXiv预印本搜索,PDF 直链无需
OpenAlex期刊/会议影响因子、h-index需要 OPENALEX_API_KEY(免费)

前置要求

安装

git clone https://github.com/Linductor-alkaid/academic-search-mcp.git
cd academic-search-mcp
npm install
npm run build

Claude Desktop 配置

将以下内容合并到 Claude Desktop 的 claude_desktop_config.json:

{
  "mcpServers": {
    "academic-search": {
      "command": "node",
      "args": ["/path/to/academic-search-mcp/dist/index.js"],
      "env": {
        "OPENALEX_API_KEY": "your_openalex_key_here",
        "S2_API_KEY": "your_s2_key_here"
      }
    }
  }
}

Windows 路径使用正斜杠 / 或双反斜杠 \\。

工具列表

search_papers

通过 Semantic Scholar 搜索论文。

参数类型默认值说明
querystring必填搜索关键词
year_startnumber—起始年份
year_endnumber—结束年份
fields_of_studystring"Computer Science"研究领域
limitnumber20返回数量(1-100)

返回:title、authors、year、abstract(前300字)、citation_count、venue、DOI/arXiv ID


get_paper_details

获取论文完整信息,包含参考文献和被引论文列表。

参数类型说明
paper_idstringS2ID、DOI:10.xxx 或 ARXIV:2301.xxxxx

返回:完整摘要、PDF 链接、参考文献(前20条)、被引论文(前20条,按引用数排序)


search_arxiv_papers

搜索 arXiv 预印本,支持分类过滤。

参数类型默认值说明
querystring必填搜索关键词
categoriesstring[]["cs.RO"]arXiv 分类,如 cs.RO、cs.LG、eess.SY
max_resultsnumber20最大返回数量
date_fromstring—起始日期,格式 YYYY-MM-DD

返回:arXiv ID、title、authors、abstract、published_date、pdf_url、categories


get_journal_metrics

通过 OpenAlex 查询期刊或会议的影响力指标。

参数类型说明
venue_namestring期刊/会议名称,如 "ICRA"、"Nature Robotics"

返回:impact_factor(2yr)、h_index、works_count、cited_by_count、homepage_url


get_author_info

查询作者的学术指标和代表作。

参数类型说明
author_namestring作者姓名(与 author_id 二选一)
author_idstringSemantic Scholar 作者 ID

返回:h_index、citation_count、paper_count、affiliations、代表作(前10篇,按引用数排序)


get_citations

获取引用指定论文的论文列表。

参数类型默认值说明
paper_idstring必填S2ID、DOI:10.xxx 或 ARXIV:2301.xxxxx
limitnumber20返回数量(1-100)

返回:引用该论文的论文列表,按 citation_count 降序排列

使用示例

搜索近两年机器人强化学习论文:

帮我搜索 2023-2025 年关于 "robot manipulation reinforcement learning" 的高引用论文

查看 ICRA 会议指标:

ICRA 会议的影响因子和 h-index 是多少?

查找某篇论文的所有引用:

帮我找引用了 "Soft Actor-Critic" 这篇论文的最新高引用论文

查询作者信息:

Sergey Levine 的 h-index 是多少,他最有影响力的论文有哪些?

搜索最新 arXiv 预印本:

搜索 2024 年以来 cs.RO 和 cs.LG 分类下关于 "diffusion policy" 的论文

论文 ID 格式速查表

所有接受 paper_id 的工具(get_paper_details / get_citations)支持以下 5 种格式,自动归一化到 Semantic Scholar 接受的内部表示:

你传的自动归一化为备注
2402.18294ARXIV:2402.18294裸 arXiv ID(YYMM.NNNNN)
ARXIV:2402.18294ARXIV:2402.18294大小写不敏感
10.1109/IROS.2024.10801451DOI:10.1109/...裸 DOI
DOI:10.1109/...DOI:10.1109/...
40 位 hex(如 9e1c2411c873a95843c4ce670fb53569c65059d6)原样S2 paperId

无法识别的格式会返回 400 错误并附「支持的格式」清单。

论文详情输出体积控制

get_paper_details 默认会包含参考文献 + 被引论文各 10 条(约 30-60KB),适合大多数场景。遇到输出过大时:

参数类型默认作用
include_referencesbooltrue是否包含参考文献列表
include_citationsbooltrue是否包含被引论文列表
references_limit0-10010参考文献条数
citations_limit0-10010被引论文条数

最小化调用示例(只看摘要和元数据):

get_paper_details(paper_id="2402.18294", include_references=false, include_citations=false)

另外 formatResponse 还有两层兜底截断(单字符串字段 2000 chars / JSON 总长 50000 chars),超出部分会自动截断并附提示,不会撑爆客户端上下文。

作者消歧

get_author_info(author_name=...) 现在返回 top 5 候选作者,每个都带 author_id、机构、h-index、引用数。中文/拼音重名场景下尤其有用:

  • 主信息仍是首位候选(保持原有行为)
  • 末尾追加「搜索候选」列表 + ⚠️ 提示
  • 用 author_id="..." 重试可精确指定作者

arXiv 分类默认

search_arxiv_papers 默认 categories=["cs.RO"](仅机器人学方向)。跨分类搜索需显式传:

search_arxiv_papers(query="...", categories=["cs.RO", "cs.LG", "eess.SY"])

OpenAlex 字段说明

⚠️ get_journal_metrics 返回的「2yr mean citedness」不是 JCR Impact Factor,而是 OpenAlex 自有指标。

  • 会议(type=conference):无此字段,会标记 N/A,请参考 h-index 和总引用数
  • 期刊(type=journal):可参考,但与 JCR IF 数值不同(口径差异)

摘要长度自定义

search_papers 和 search_arxiv_papers 默认摘要截断 300 字符,方法描述容易被截断。设大一点:

search_papers(query="...", abstract_chars=2000)

abstract_chars=0 表示不截断。

v1.0.0 → v1.1.0 迁移指南

v1.1.0 包含 1 处破坏性变更 和 1 处行为默认值变更。其他都是新增可选参数(向后兼容)。本文档面向直接解析 get_journal_metrics JSON dump 的下游用户。

破坏性变更:VenueMetrics.impactFactor 重命名

OpenAlex 的 summary_stats['2yr_mean_citedness'] 不是 JCR Impact Factor。旧名 impactFactor 误导性极强(ICRA 返回 0.000 像 bug,实际是该字段对会议本就无意义)。

// 旧 (v1.0.0)
const venue = parseJsonDump(getJournalMetrics("ICRA"));
console.log(venue[0].impactFactor);  // → undefined(字段没了)

// 新 (v1.1.0)
const venue = parseJsonDump(getJournalMetrics("ICRA"));
console.log(venue[0].twoYearMeanCitedness);  // → null(会议无此字段)或数值(期刊)

迁移动作:

  • 如果你的代码访问 v.impactFactor,改为 v.twoYearMeanCitedness
  • 如果依赖 impactFactor !== null 判断「这是期刊」,改为 v.type !== "conference"
  • 会议(type=conference)现在永远返回 twoYearMeanCitedness: null,markdown 块会显示 N/A(会议无此指标,参考 h-index / 总引用数)

行为变更:get_paper_details 默认条数 20 → 10

旧版本 references 和 citations 各固定 20 条(合计可能 ~134K chars)。v1.1.0 默认改为 10/10(约 30-60K),更安全。

// 旧 (v1.0.0)
get_paper_details(paper_id="ARXIV:2402.18294")
  → 返回 references × 20, citations × 20

// 新 (v1.1.0) — 默认行为变了
get_paper_details(paper_id="ARXIV:2402.18294")
  → 返回 references × 10, citations × 10

迁移动作(如果你需要完整列表):

  • 想要旧行为:get_paper_details(paper_id="...", references_limit=20, citations_limit=20)
  • 想要极致精简(只看摘要):get_paper_details(paper_id="...", include_references=false, include_citations=false)

新增可选参数(无破坏,向后兼容)

工具新参数旧调用者需要改吗
get_paper_detailsinclude_references, include_citations, references_limit, citations_limit❌ 不需要
get_citations / get_paper_detailspaper_id 现在接受裸 arXiv ID / 裸 DOI❌ 不需要(旧格式仍工作)
search_papers / search_arxiv_papersabstract_chars❌ 不需要
get_author_infoname search 现在返回 top-5 候选列表❌ 不需要(首位仍是主信息)

升级建议

cd academic-search-mcp
git pull origin master
npm install   # 无新依赖,但保险起见
npm run build

Claude Desktop 配置无需修改(无新增 env vars,无 schema 不兼容)。重启 Claude Desktop 让新版本生效。


限速说明

  • Semantic Scholar(无 key):100 req/5min,遇到 429 自动指数退避重试(1s→2s→4s)
  • Semantic Scholar(有 key):1 req/sec,基本不限速
  • arXiv:无硬性限制,建议间隔 3s
  • OpenAlex(有 key):$1/day 预算,日常使用足够

开发

npm run build      # 编译 TypeScript
npm run dev        # 监听模式编译

MCP Inspector 调试(需先全局安装或使用 npx):

OPENALEX_API_KEY=xxx node dist/index.js
Ver o original no GitHub

Bom para

Relacionados