Install
$ agentstack add mcp-gqy20-article-mcp ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
Article MCP 文献搜索服务器
[](https://glama.ai/mcp/servers/@gqy20/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
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: gqy20
- Source: gqy20/article-mcp
- License: MIT
- Homepage: https://pypi.org/project/article-mcp/
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.