About Article MCP
Article MCP is an MCP server published by gqy20 in the Developer Tools category: 文献检索MCP.
The repository has 16 stars and 4 forks, with the last commit 9 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/gqy20/article-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Article MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
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
README fetched from the repository 5 days ago. The original is authoritative.