Skip to main content

Article MCP 文献搜索服务器

MCP Server

基于 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

Metadata

Release files for article-mcp 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for article-mcp 0.2.2
File Size Uploaded
article_mcp-0.2.2.tar.gz 209.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for article-mcp 0.2.2
File Interpreter ABI Platform
article_mcp-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 304.8 kB

Release files / article_mcp-0.2.2.tar.gz

Download URL article_mcp-0.2.2.tar.gz
Size 209.2 kB
Tags Source
SHA-256 checksum
How to use checksums
d53ed63fab120aa2017a694d37254843938c9af19924de56fce6b580381d0f33
BLAKE2b-256 checksum
How to use checksums
84d633a7bfc8931fa5e07f80a03b096cafa931f2be1feaceac092238a2d9dc4b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.12

Release files / article_mcp-0.2.2-py3-none-any.whl

Download URL article_mcp-0.2.2-py3-none-any.whl
Size 95.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
98b9c9304578a6b3edb6d234c6fc0261cf2ef63e2e669bd31bcb8ea59a516514
BLAKE2b-256 checksum
How to use checksums
aac4a52fe9bf4b00dfdcce0712b48c7b92af8c6a3f5c048072247b489e18bf38
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.12

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page