Article MCP 文献搜索服务器

基于 FastMCP v2.13+ 的异步文献搜索工具，集成 Europe PMC、PubMed、arXiv、CrossRef、OpenAlex 等数据源。

快速开始

# 安装
uvx article-mcp

# 或本地开发
git clone https://github.com/gqy20/article-mcp.git && cd article-mcp
uv sync
uv run python -m article_mcp

配置

Claude Desktop

{
  "mcpServers": {
    "article-mcp": {
      "command": "uvx",
      "args": ["article-mcp"],
      "env": {
        "EASYSCHOLAR_SECRET_KEY": "your_key_here"
      }
    }
  }
}

EASYSCHOLAR_SECRET_KEY 为可选项，访问 EasyScholar 注册获取。

Cherry Studio

同上，如遇 Unicode 问题添加 env: {"PYTHONIOENCODING": "utf-8"}

5 个核心工具

工具	功能	数据源	主要参数
search_literature	多源文献搜索	Europe PMC, PubMed, arXiv, CrossRef, OpenAlex	keyword, max_results
get_article_details	获取文献详情（支持参数容错）	Europe PMC, CrossRef, OpenAlex, arXiv, PubMed	identifier, id_type, sources
get_references	获取参考文献	Europe PMC, CrossRef, PubMed	identifier, max_results
get_literature_relations	文献关系分析	Europe PMC, PubMed, CrossRef, OpenAlex	identifiers, relation_types
get_journal_quality	期刊质量评估	EasyScholar, OpenAlex	journal_name, include_metrics

数据源说明

Europe PMC

• 内容：生物医学文献全文、摘要
• 限制：1 req/s
• 用途：搜索、全文获取、参考文献

PubMed

• 内容：生物医学文献摘要
• 限制：无严格限制
• 用途：搜索补充

arXiv

• 内容：预印本论文
• 限制：3 req/request
• 用途：预印本搜索

CrossRef

• 内容：跨出版社元数据
• 限制：50 req/s
• 用途：参考文献查询

OpenAlex

• 内容：开放学术图谱
• 限制：无限制
• 用途：引用关系、h 指标

EasyScholar

• 内容：期刊质量指标
• 限制：建议配置密钥
• 用途：影响因子、分区

使用示例

// 搜索（默认使用 Europe PMC + PubMed）
{"keyword": "machine learning", "max_results": 10}

// 指定数据源搜索
{"keyword": "cancer", "sources": ["europe_pmc", "arxiv"]}

// 获取全文
{"pmcid": "PMC1234567"}

// 获取指定章节
{"pmcid": "PMC1234567", "sections": ["methods", "results"]}

// 批量获取
{"pmcid": ["PMC123", "PMC456"]}

// 获取参考文献（默认 Europe PMC + CrossRef）
{"identifier": "10.1038/nature12373", "max_results": 20}

// 文献关系分析
{"identifiers": "10.1038/nature12373", "relation_types": ["references", "similar"]}

// 期刊质量（EasyScholar + OpenAlex 双源）
{"journal_name": "Nature", "include_metrics": ["impact_factor", "h_index"]}

参数容错特性

get_article_details 工具会自动修正以下格式错误：

输入	自动修正为
"pmcid": "[\"a\", \"b\"]"	["a", "b"]
"sections": "methods"	["methods"]

API 限制汇总

API	限制	用途
Europe PMC	1 req/s	全文、参考文献
Crossref	50 req/s	参考文献
arXiv	3 req/request	预印本
OpenAlex	无限制	引用关系、指标
EasyScholar	建议配置密钥	期刊质量

故障排除

问题	解决方案
cannot import 'hdrs' from 'aiohttp'	uv sync --upgrade
MCP 服务器启动失败	检查配置中的路径是否使用绝对路径
API 请求失败	检查网络连接
期刊质量数据缺失	配置 EASYSCHOLAR_SECRET_KEY

许可证

MIT License