article-mcp
This server enables multi-source academic literature retrieval and analysis via the MCP protocol, aggregating data from Europe PMC, PubMed, arXiv, CrossRef, OpenAlex, and EasyScholar.
Search Literature: Search for academic papers using keywords with four strategies:
comprehensive– all available sourcesfast– major sources only (Europe PMC, PubMed)precise– authoritative sources with result intersectionpreprint– arXiv preprintsReturns metadata (title, authors, abstract, PMCID, DOI, etc.) with 24-hour caching.
Retrieve Full Text: Fetch full-text articles by PMCID (single or batch, up to 20). Supports multiple formats (Markdown, XML, plain text) and selective section extraction (e.g., methods, results, discussion).
Retrieve References: Get the reference list of an article identified by DOI, PMID, or PMCID, with smart deduplication and optional detailed metadata, across multiple data sources.
Analyze Literature Relations: Explore citation relationships between articles—including cited references, similar articles, and citing papers—via single, batch, or network analysis modes with configurable depth.
Assess Journal Quality: Evaluate journals using:
EasyScholar metrics: impact factor, SCI quartile (Q1–Q4), JCI index, CAS zone
OpenAlex metrics: h-index, citation rate, total citations, i10-index
Supports batch queries and gracefully falls back to OpenAlex if EasyScholar is unavailable.
Server Info & Cache Management: Access server version, status, supported sources, available tools, and view cache statistics for searches and journal quality data.
Configuration: Supports environment variables for API keys (e.g.,
EASYSCHOLAR_SECRET_KEY) and language settings (English or Chinese tool descriptions).
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@article-mcpfind recent papers on CRISPR gene editing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Article MCP
基于 Model Context Protocol (MCP) 的学术文献检索服务器。帮助 LLM 搜索、获取和分析多数据源学术文献。
主要用途:面向学术文献与科研论文检索分析,尤其适合医学、生命科学和跨学科科研场景;同时支持 arXiv 等通用科研预印本来源。
适用范围
适用于需要 LLM 进行以下操作的场景:
学术写作辅助 — 查找最新研究文献作为引用来源
文献综述 — 跨多个学术数据库检索和分析文献
期刊质量评估 — 评估目标期刊的学术影响力(影响因子、分区等)
文献关系分析 — 构建引用网络、发现相似文献
支持 6 个学术数据源:Europe PMC、PubMed、arXiv、CrossRef、OpenAlex、Semantic Scholar。
注意: 本工具返回文献元数据(标题、作者、摘要、PMCID、DOI 等)。全文获取需通过
get_article_details工具,且仅限 PMC 开放获取文章。
Related MCP server: academic-mcp
快速开始
系统要求: Node.js 18+
# 直接运行(推荐,自动获取最新版本)
npx article-mcp@latest
# 或全局安装
npm install -g article-mcp
article-mcpClaude Desktop 配置
{
"mcpServers": {
"article-mcp": {
"command": "npx",
"args": ["article-mcp@latest"],
"env": {
"OPENALEX_API_KEY": "your_openalex_key_here",
"EASYSCHOLAR_SECRET_KEY": "your_easyscholar_key_here"
}
}
}
}VS Code 配置
在 .vscode/mcp.json 中添加:
{
"servers": {
"article-mcp": {
"type": "stdio",
"command": "npx",
"args": ["article-mcp@latest"],
"env": {
"OPENALEX_API_KEY": "your_openalex_key_here",
"EASYSCHOLAR_SECRET_KEY": "your_easyscholar_key_here"
}
}
}
}Windows 用户: 如果遇到
npx无法识别的问题,将"command"改为"cmd","args"改为["/c", "npx", "article-mcp@latest"]。
功能特性
功能 | 工具 | 说明 |
🔍 多源文献搜索 |
| 跨 5 个数据源并行搜索,支持 4 种搜索策略,自动去重排序 |
📄 文献全文获取 |
| 通过 PMCID 获取 PMC 全文(Markdown/XML/Text),支持批量 20 篇 |
📚 参考文献获取 |
| 多源获取参考文献列表,智能 DOI/标题去重,源优先级排序 |
🔗 文献关系分析 |
| 引用网络、施引文献、相似文献,支持多深度网络分析 |
📊 期刊质量评估 |
| 影响因子、JCR 分区、JCI、中科院分区、h 指数等,双数据源互补 |
工具说明
search_literature — 文献搜索
查找文献并获取 PMCID(不含全文)。如需全文,用返回的 PMCID 调用 get_article_details。
参数 | 类型 | 默认值 | 说明 |
| string | 必填 | 搜索关键词 |
| enum |
| 搜索策略: |
| string[] | 按策略选择 | 数据源: |
| integer |
| 每个源的最大结果数,范围 1-100 |
| boolean |
| 是否使用 24 小时文件缓存 |
get_article_details — 文献全文
通过 PMCID 获取全文内容。仅支持 PMC 开放获取文章。
返回说明:fulltext.content 返回所选格式的完整正文;fulltext.preview 是用于快速浏览的 1200 字符预览;fulltext.content_length 标识完整正文长度。
参数 | 类型 | 默认值 | 说明 |
| string | string[] | 必填 | PMCID 标识符,批量最多 20 个 |
| enum |
| 全文格式: |
| string | string[] | null |
|
|
get_references — 参考文献
获取某文献引用的参考文献列表。
参数 | 类型 | 默认值 | 说明 |
| string | 必填 | DOI、PMID 或 PMCID |
| enum |
| 标识符类型: |
| integer |
| 最大参考文献数量,范围 1-100 |
| string[] |
| 数据源 |
| boolean |
| 是否包含详细元数据 |
get_literature_relations — 文献关系分析
分析文献间的引用关系、施引文献和相似文献。
施引说明:citing 默认同时尝试 OpenAlex 与 Europe PMC;如果显式传入 sources,则只使用其中支持施引的 openalex/europe_pmc。OpenAlex 路径需要 OPENALEX_API_KEY,Europe PMC 可作为备选来源。
参数 | 类型 | 默认值 | 说明 |
| string | string[] |
| DOI、PMID 或 PMCID |
| enum |
| 标识符类型 |
| enum[] |
| 关系类型 |
| integer |
| 每种关系最大结果数,范围 1-100 |
| enum |
|
|
| integer |
| 网络分析展开深度 |
get_journal_quality — 期刊质量评估
集成 EasyScholar + OpenAlex 双数据源。
失败说明:当 EasyScholar 与 OpenAlex 都无法返回任何可用指标时,工具会返回 isError: true 和明确错误信息,而不是成功返回空指标。
参数 | 类型 | 默认值 | 说明 |
| string | string[] | 必填 | 期刊名称 |
| string | string[] | null |
| 返回指标: |
| enum | null |
| 排序字段(批量查询): |
| enum |
|
|
| boolean |
| 是否使用 24 小时文件缓存 |
环境变量
变量 | 必需 | 获取地址/配置作用 | 缺失后果 |
| OpenAlex 相关能力需要 | OpenAlex account,用于 OpenAlex 搜索、施引和期刊指标 | OpenAlex 源失败; |
| 期刊影响因子/分区需要 | 期刊质量只尝试 OpenAlex 指标,影响因子/分区可能为空 | |
| 推荐 | NCBI E-utilities 联系邮箱 | 仍可请求,但不利于 NCBI 联系和合规使用 |
| 可选 | PubMed/PMC 速率按 3 req/s 保守限制 | |
| 推荐 | Crossref Polite Pool 联系邮箱 | 仍可请求,但不会进入 Polite Pool |
| 推荐 | 施引上下文请求更容易受限 | |
| 可选 | OpenAlex 请求间隔覆盖值,默认 100ms | 使用默认限流 |
| 可选 | arXiv 请求间隔覆盖值,默认 3000ms | 使用默认限流 |
| 可选 | Europe PMC 请求间隔覆盖值,默认 1000ms | 使用默认限流 |
| 可选 | NCBI 请求间隔覆盖值;未设置时有 key 默认 100ms,无 key 默认 333ms | 使用自动限流 |
| 可选 | 工具说明语言: | 使用中文工具说明 |
使用示例
基本搜索流程
用户: 搜索 CRISPR 基因编辑的最新文献
LLM: 调用 search_literature(keyword="CRISPR gene editing", search_type="fast")
→ 返回 10 条结果的元数据(标题、作者、PMCID、摘要等)
用户: 获取第一篇文献的全文
LLM: 调用 get_article_details(pmcid="PMC1234567")
→ 返回全文内容(Markdown 格式)期刊评估
用户: 查看 Nature 的影响因子
LLM: 调用 get_journal_quality(journal_name="Nature")
→ 返回 impact_factor、quartile、jci 等指标批量期刊比较
用户: 比较 Nature、Science、Cell 的质量指标
LLM: 调用 get_journal_quality(
journal_name=["Nature", "Science", "Cell"],
sort_by="impact_factor"
)
→ 按影响因子降序返回三本期刊的指标数据源说明
数据源 | 搜索 | 详情 | 全文 | 参考文献 | 施引文献 | 相似文献 |
Europe PMC | ✅ | ✅ | — | ✅ | ✅ | — |
PubMed | ✅ | ✅ | ✅ | ✅ | — | ✅ |
arXiv | ✅ | — | — | — | — | — |
Crossref | ✅ | ✅ | — | ✅ | — | — |
OpenAlex | ✅ | ✅ | — | — | ✅ | — |
Semantic Scholar | — | — | — | — | ✅ | — |
输出说明
structuredContent使用统一的{ success, data, meta, warnings, error }结构content首段为可读摘要和关键摘录,次段为同一结构化结果的 JSON 备份 以兼容旧 MCP 客户端服务器只注册 Tools,不注册 Resources 或 Prompts,确保最大客户端兼容性
调试
使用 MCP Inspector 检查和调试工具调用:
# 启动 Inspector
npx @modelcontextprotocol/inspector node dist/index.js日志输出到 stderr(不污染 stdout 协议通道)。在客户端日志中查看请求耗时和状态。
开发
npm install # 安装依赖
npm run dev # 开发模式(tsx 热重载)
npm run build # 生产构建
npm test # 运行 91 个 Vitest 测试
npm run test:mcp # MCP 合规检查(目标: 100/100)
npm run test:all # 完整门禁:version-check → typecheck → lint → build → test → test:mcp许可证
MIT © fangfuzha
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/fangfuzha/article-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server