article-mcp 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,526 @@
1
+ Metadata-Version: 2.4
2
+ Name: article-mcp
3
+ Version: 0.1.0
4
+ Summary: Article MCP文献搜索服务器 - 基于Europe PMC、arXiv等多个数据源的学术文献搜索工具
5
+ Author-email: gqy20 <qingyu_ge@foxmail.com>
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/gqy20/article-mcp
8
+ Project-URL: Repository, https://github.com/gqy20/article-mcp
9
+ Project-URL: Issues, https://github.com/gqy20/article-mcp/issues
10
+ Keywords: mcp,literature,search,europe-pmc,arxiv,academic
11
+ Requires-Python: >=3.10
12
+ Description-Content-Type: text/markdown
13
+ Requires-Dist: fastmcp>=2.0.0
14
+ Requires-Dist: requests>=2.25.0
15
+ Requires-Dist: python-dateutil>=2.8.0
16
+ Requires-Dist: urllib3>=1.26.0
17
+ Requires-Dist: aiohttp>=3.9.0
18
+ Requires-Dist: markdownify>=0.12.0
19
+ Provides-Extra: dev
20
+ Requires-Dist: pytest>=7.0.0; extra == "dev"
21
+ Requires-Dist: black>=22.0.0; extra == "dev"
22
+ Requires-Dist: flake8>=4.0.0; extra == "dev"
23
+ Dynamic: requires-python
24
+
25
+ # Europe PMC 文献搜索 MCP 服务器
26
+
27
+ > 🔬 基于 FastMCP 框架开发的专业文献搜索工具,可与 Claude Desktop、Cherry Studio 等 AI 助手无缝集成
28
+
29
+ ## 🚀 快速开始
30
+
31
+ ### 0️⃣ 克隆项目
32
+
33
+ ```bash
34
+ # 克隆项目到本地
35
+ git clone https://github.com/gqy20/article-mcp.git
36
+ cd article-mcp
37
+ ```
38
+
39
+ ### 1️⃣ 安装依赖
40
+
41
+ ```bash
42
+ # 方法一:使用 uv (推荐)
43
+ curl -LsSf https://astral.sh/uv/install.sh | sh # 安装 uv
44
+ uv sync # 安装项目依赖
45
+
46
+ # 方法二:使用 pip
47
+ pip install fastmcp requests python-dateutil aiohttp
48
+ ```
49
+
50
+ ### 2️⃣ 启动服务器
51
+
52
+ ```bash
53
+ # 启动 MCP 服务器
54
+ uv run main.py server
55
+
56
+ # 或使用 Python
57
+ python main.py server
58
+ ```
59
+
60
+ ### 3️⃣ 配置 AI 客户端
61
+
62
+ #### Claude Desktop 配置
63
+
64
+ 编辑 Claude Desktop 配置文件,添加:
65
+
66
+ ```json
67
+ {
68
+ "mcpServers": {
69
+ "article-mcp": {
70
+ "command": "uv",
71
+ "args": [
72
+ "run",
73
+ "--directory",
74
+ "D:\\你的项目路径\\article-mcp",
75
+ "main.py",
76
+ "server"
77
+ ],
78
+ "env": {
79
+ "PYTHONUNBUFFERED": "1"
80
+ }
81
+ }
82
+ }
83
+ }
84
+ ```
85
+
86
+ #### Cherry Studio 配置
87
+
88
+ ```json
89
+ {
90
+ "mcpServers": {
91
+ "article-mcp": {
92
+ "command": "uv",
93
+ "args": [
94
+ "run",
95
+ "--directory",
96
+ "你的项目路径\\article-mcp",
97
+ "main.py",
98
+ "server"
99
+ ],
100
+ "env": {
101
+ "PYTHONUNBUFFERED": "1"
102
+ }
103
+ }
104
+ }
105
+ }
106
+ ```
107
+
108
+ ### 4️⃣ 开始使用
109
+
110
+ 配置完成后,重启你的 AI 客户端,即可使用以下功能:
111
+
112
+ - 🔍 搜索学术文献 (`search_europe_pmc`)
113
+ - 📄 获取文献详情 (`get_article_details`)
114
+ - 📚 获取参考文献 (`get_references_by_doi`)
115
+ - 🔗 批量处理DOI (`batch_enrich_references_by_dois`)
116
+ - 📰 搜索arXiv预印本 (`search_arxiv_papers`)
117
+ - ⭐ 评估期刊质量 (`get_journal_quality`)
118
+
119
+ ---
120
+
121
+ ## 📋 完整功能列表
122
+
123
+ ### 核心搜索工具
124
+
125
+ | 工具名称 | 功能描述 | 主要参数 |
126
+ |---------|---------|----------|
127
+ | `search_europe_pmc` | 搜索 Europe PMC 文献数据库 | `keyword`, `start_date`, `end_date`, `max_results` |
128
+ | `get_article_details` | 获取特定文献详细信息(支持PMID、DOI、PMCID) | `identifier`, `id_type`, `mode` |
129
+ | `search_arxiv_papers` | 搜索 arXiv 预印本文献 | `keyword`, `start_date`, `end_date`, `max_results` |
130
+
131
+ ### 参考文献工具
132
+
133
+ | 工具名称 | 功能描述 | 主要参数 |
134
+ |---------|---------|----------|
135
+ | `get_references_by_doi` | 通过DOI获取参考文献列表 | `doi` |
136
+ | `batch_enrich_references_by_dois` | 批量补全多个DOI参考文献 | `dois[]` (最多20个) |
137
+ | `get_similar_articles` | 获取相似文章推荐 | `identifier`, `id_type`, `max_results` |
138
+ | `get_citing_articles` | 获取引用该文献的文章 | `identifier`, `id_type`, `max_results` |
139
+ | `get_literature_relations` | 获取文献的所有关联信息 | `identifier`, `id_type`, `max_results` |
140
+
141
+ ### 质量评估工具
142
+
143
+ | 工具名称 | 功能描述 | 主要参数 |
144
+ |---------|---------|----------|
145
+ | `get_journal_quality` | 获取期刊影响因子、分区等 | `journal_name`, `secret_key` |
146
+ | `evaluate_articles_quality` | 批量评估文献期刊质量 | `articles[]`, `secret_key` |
147
+
148
+ ---
149
+
150
+ ## ⚡ 性能特性
151
+
152
+ - 🚀 **高性能并行处理** - 比传统方法快 30-50%
153
+ - 💾 **智能缓存机制** - 24小时本地缓存,避免重复请求
154
+ - 🔄 **批量处理优化** - 支持最多20个DOI同时处理
155
+ - 🛡️ **自动重试机制** - 网络异常自动重试
156
+ - 📊 **详细性能统计** - 实时监控API调用情况
157
+
158
+ ---
159
+
160
+ ## 🔧 高级配置
161
+
162
+ ### 环境变量
163
+
164
+ ```bash
165
+ export PYTHONUNBUFFERED=1 # 禁用Python输出缓冲
166
+ export UV_LINK_MODE=copy # uv链接模式(可选)
167
+ ```
168
+
169
+ ### 传输模式
170
+
171
+ ```bash
172
+ # STDIO 模式 (推荐用于桌面AI客户端)
173
+ uv run main.py server --transport stdio
174
+
175
+ # SSE 模式 (用于Web应用)
176
+ uv run main.py server --transport sse --host 0.0.0.0 --port 9000
177
+
178
+ # HTTP 模式 (用于API集成)
179
+ uv run main.py server --transport streamable-http --host 0.0.0.0 --port 9000
180
+ ```
181
+
182
+ ### API 限制与优化
183
+
184
+ - **Crossref API**: 50 requests/second (建议提供邮箱获得更高限额)
185
+ - **Europe PMC API**: 1 request/second (保守策略)
186
+ - **arXiv API**: 3 seconds/request (官方限制)
187
+
188
+ ---
189
+
190
+ #### 获取文献的所有关联信息
191
+
192
+ ```json
193
+ {
194
+ "identifier": "10.1000/xyz123",
195
+ "id_type": "doi",
196
+ "max_results": 10
197
+ }
198
+ ```
199
+
200
+ ---
201
+
202
+ ## 🛠️ 开发与测试
203
+
204
+ ### 运行测试
205
+
206
+ ```bash
207
+ # 运行功能测试
208
+ uv run main.py test
209
+
210
+ # 性能测试
211
+ uv run python test_performance_comparison.py
212
+
213
+ # 查看项目信息
214
+ uv run main.py info
215
+ ```
216
+
217
+ ### 故障排除
218
+
219
+ | 问题 | 解决方案 |
220
+ |------|---------|
221
+ | `cannot import name 'hdrs' from 'aiohttp'` | 运行 `uv sync --upgrade` 更新依赖 |
222
+ | `MCP服务器启动失败` | 检查路径配置,确保使用绝对路径 |
223
+ | `API请求失败` | 提供邮箱地址,检查网络连接 |
224
+ | `找不到uv命令` | 使用完整路径:`C:\Users\用户名\.local\bin\uv.exe` |
225
+
226
+ ### 项目结构
227
+
228
+ ```
229
+ mcp1/
230
+ ├── main.py # 主入口文件
231
+ ├── src/ # 核心服务模块
232
+ │ ├── europe_pmc.py # Europe PMC API
233
+ │ ├── reference_service.py # 参考文献服务
234
+ │ └── pubmed_search.py # PubMed搜索
235
+ ├── pyproject.toml # 项目配置
236
+ ├── uv.lock # 依赖锁定文件
237
+ └── README.md # 项目文档
238
+ ```
239
+
240
+ ---
241
+
242
+ ## 📄 返回数据格式
243
+
244
+ 每篇文献包含以下标准字段:
245
+
246
+ ```json
247
+ {
248
+ "pmid": "文献ID",
249
+ "title": "文献标题",
250
+ "authors": ["作者1", "作者2"],
251
+ "journal_name": "期刊名称",
252
+ "publication_date": "发表日期",
253
+ "abstract": "摘要",
254
+ "doi": "DOI标识符",
255
+ "pmid_link": "文献链接"
256
+ }
257
+ ```
258
+
259
+ ---
260
+
261
+ ## 🌐 魔搭MCP广场部署
262
+
263
+ ### 快速托管到魔搭MCP广场
264
+
265
+ 魔搭(ModelScope)MCP广场为MCP服务提供云托管服务,基于阿里云函数计算,支持:
266
+ - ⚡ 毫秒级弹性启动
267
+ - 🔒 多租安全隔离
268
+ - 🌐 自动生成SSE服务地址
269
+ - 🛡️ 内置Bearer鉴权能力
270
+ - 📊 按实际调用计费
271
+
272
+ ### 部署步骤
273
+
274
+ 1. **访问魔搭MCP广场**:[https://modelscope.cn/mcp](https://modelscope.cn/mcp)
275
+
276
+ 2. **添加MCP服务**,使用以下配置:
277
+
278
+ #### 推荐配置(完整版)
279
+
280
+ ```json
281
+ {
282
+ "mcpServers": {
283
+ "article-mcp": {
284
+ "command": "uv",
285
+ "args": [
286
+ "run",
287
+ "python",
288
+ "main.py",
289
+ "server"
290
+ ],
291
+ "repository": "https://github.com/gqy20/article-mcp.git",
292
+ "branch": "master",
293
+ "env": {
294
+ "PYTHONUNBUFFERED": "1"
295
+ },
296
+ "protocol": "stdio",
297
+ "runtime": "debian12",
298
+ "metadata": {
299
+ "name": "文献检索MCP",
300
+ "description": "基于Europe PMC、arXiv等多个数据源的学术文献搜索工具",
301
+ "version": "0.2.0",
302
+ "author": "gqy20",
303
+ "category": "学术工具",
304
+ "tags": ["文献检索", "学术搜索", "Europe PMC", "arXiv", "引用分析"]
305
+ }
306
+ }
307
+ }
308
+ }
309
+ ```
310
+
311
+ #### 简化配置(最小版)
312
+
313
+ ```json
314
+ {
315
+ "mcpServers": {
316
+ "article-mcp": {
317
+ "command": "uv",
318
+ "args": [
319
+ "run",
320
+ "python",
321
+ "main.py",
322
+ "server"
323
+ ],
324
+ "repository": "https://github.com/gqy20/article-mcp.git",
325
+ "env": {
326
+ "PYTHONUNBUFFERED": "1"
327
+ }
328
+ }
329
+ }
330
+ }
331
+ ```
332
+
333
+ 3. **提交配置**,魔搭将自动:
334
+ - 拉取GitHub仓库代码
335
+ - 安装依赖(通过uv)
336
+ - 部署到函数计算
337
+ - 生成SSE服务地址
338
+
339
+ 4. **测试服务**:在MCP Playground中测试您的服务
340
+
341
+ ### 特性优势
342
+
343
+ - 🚀 **秒级部署**:约1秒完成MCP服务部署
344
+ - 📦 **零运维**:无需管理服务器和基础设施
345
+ - 🔄 **自动转换**:STDIO模式自动转换为SSE服务
346
+ - 💰 **按需付费**:仅为实际使用时长付费
347
+ - 🛡️ **安全隔离**:每个租户独立的SSE地址和运行环境
348
+
349
+ ---
350
+
351
+ ## 📦 发布包管理
352
+
353
+ ### PyPI 包发布
354
+
355
+ 项目已发布到 PyPI,支持通过 `uvx` 命令直接运行:
356
+
357
+ ```bash
358
+ # 从PyPI安装后直接运行(推荐)
359
+ uvx article-mcp server
360
+
361
+ # 或先安装后运行
362
+ pip install article-mcp
363
+ article-mcp server
364
+
365
+ # 本地开发测试
366
+ uvx --from . article-mcp server
367
+ ```
368
+
369
+ ### NPM 包装器
370
+
371
+ 为兼容性提供了 NPM 包装器:
372
+
373
+ ```bash
374
+ # 使用npx运行
375
+ npx @gqy20/article-mcp-wrapper@latest server
376
+ ```
377
+
378
+ ### 魔搭MCP广场配置选项
379
+
380
+ 根据部署检测要求,提供三种配置方案:
381
+
382
+ #### 🥇 方案1:使用 uvx(推荐)
383
+
384
+ ```json
385
+ {
386
+ "mcpServers": {
387
+ "article-mcp": {
388
+ "command": "uvx",
389
+ "args": [
390
+ "--from",
391
+ "git+https://github.com/gqy20/article-mcp.git",
392
+ "article-mcp",
393
+ "server"
394
+ ],
395
+ "env": {
396
+ "PYTHONUNBUFFERED": "1"
397
+ }
398
+ }
399
+ }
400
+ }
401
+ ```
402
+
403
+ #### 🥈 方案2:使用 npx
404
+
405
+ ```json
406
+ {
407
+ "mcpServers": {
408
+ "article-mcp": {
409
+ "command": "npx",
410
+ "args": [
411
+ "-y",
412
+ "@gqy20/article-mcp-wrapper@latest",
413
+ "server"
414
+ ],
415
+ "env": {
416
+ "PYTHONUNBUFFERED": "1"
417
+ }
418
+ }
419
+ }
420
+ }
421
+ ```
422
+
423
+ #### 🥉 方案3:GitHub 仓库(需手动审核)
424
+
425
+ ```json
426
+ {
427
+ "mcpServers": {
428
+ "article-mcp": {
429
+ "command": "uvx",
430
+ "args": [
431
+ "--from",
432
+ "git+https://github.com/gqy20/article-mcp.git",
433
+ "article-mcp",
434
+ "server"
435
+ ],
436
+ "env": {
437
+ "PYTHONUNBUFFERED": "1"
438
+ }
439
+ }
440
+ }
441
+ }
442
+ ```
443
+
444
+ ### 发布说明
445
+
446
+ - **PyPI 包名**: `article-mcp`
447
+ - **NPM 包名**: `@gqy20/article-mcp-wrapper`
448
+ - **版本管理**: 统一使用语义化版本控制
449
+ - **自动更新**: 使用 `@latest` 标签确保获取最新版本
450
+
451
+ ---
452
+
453
+ ## 📜 许可证
454
+
455
+ 本项目遵循 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。
456
+
457
+ ---
458
+
459
+ ## 🤝 贡献
460
+
461
+ 欢迎提交 Issue 和 Pull Request!
462
+
463
+ 1. Fork 项目
464
+ 2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
465
+ 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
466
+ 4. 推送到分支 (`git push origin feature/AmazingFeature`)
467
+ 5. 打开 Pull Request
468
+
469
+ ---
470
+
471
+ ## 📞 支持
472
+
473
+ - 📧 提交 Issue:[GitHub Issues](https://github.com/your-repo/issues)
474
+ - 📚 文档:[项目Wiki](https://github.com/your-repo/wiki)
475
+ - 💬 讨论:[GitHub Discussions](https://github.com/your-repo/discussions)
476
+
477
+ ---
478
+
479
+ ## 📖 使用示例
480
+
481
+ ### 获取文献详情(通过PMID)
482
+
483
+ ```json
484
+ {
485
+ "identifier": "12345678",
486
+ "id_type": "pmid"
487
+ }
488
+ ```
489
+
490
+ ### 获取文献详情(通过DOI)
491
+
492
+ ```json
493
+ {
494
+ "identifier": "10.1000/xyz123",
495
+ "id_type": "doi"
496
+ }
497
+ ```
498
+
499
+ ### 获取文献详情(通过PMCID)
500
+
501
+ ```json
502
+ {
503
+ "identifier": "PMC1234567",
504
+ "id_type": "pmcid"
505
+ }
506
+ ```
507
+
508
+ ### 获取文献详情(异步模式)
509
+
510
+ ```json
511
+ {
512
+ "identifier": "12345678",
513
+ "id_type": "pmid",
514
+ "mode": "async"
515
+ }
516
+ ```
517
+
518
+ ### 获取文献的所有关联信息
519
+
520
+ ```json
521
+ {
522
+ "identifier": "10.1000/xyz123",
523
+ "id_type": "doi",
524
+ "max_results": 10
525
+ }
526
+ ```
@@ -0,0 +1,28 @@
1
+ main.py,sha256=t_A4KHEZNZzpn7jfq6xUbKtN0XvB39zBrT76RbNB0N0,14555
2
+ json/mcp_config.json,sha256=Gs_e26EK6uaKwijaJi80h7tl3z6wUBN19cd2Jv6oexA,210
3
+ json/mcp_config_article_mcp.json,sha256=iBtb3JwXO-yTC4j3r4aXBeARlCLBnT-dkBAoUEfOdec,313
4
+ json/mcp_config_cherry_studio.json,sha256=5-kCSLtFI8SzdqN_BSScXxGHQq9BL-qCxSZh3pg2L_U,415
5
+ json/mcp_config_examples.json,sha256=FFnjRoqgV4KtY4CzFqslldhz9kmhhCZ-hijFUlQUcd4,6462
6
+ json/mcp_config_simple.json,sha256=4W4mbN0rV0X34vBaskI7eIlUrBB7KerMB_IlupSlUxk,282
7
+ json/mcp_config_sse.json,sha256=x6k2bqtq077FzcRBOT4seSPxSEPYl5SqfydsyljD3zA,3488
8
+ json/mcp_config_sse_client.json,sha256=h-7xfu1STTYEu-_chG5mwnstvlFzQdkr6Jn72aY3JIA,552
9
+ src/__init__.py,sha256=EXqSHRDuJmGUYQO0OqL_-HCMcuXoxKY3DyOLPRKwCXY,391
10
+ src/__main__.py,sha256=m-vbZufAC6UgGsTQ99DhGXa3Mo_N0G0EeyA6eVaPTts,62
11
+ src/arxiv_search.py,sha256=Xe4qnuciYXXhxeEXURPQa3bKLcTxsxBXu5ji5q7P29k,11101
12
+ src/europe_pmc.py,sha256=1bbdUV5QxuQ3L86jpMjtkJ4RiO3ov6uBikWJVmbqgEM,25509
13
+ src/html_to_markdown.py,sha256=2X1GPTg_MITX5Mf1YO9juITO1RdAz0eZrpFu-ggs5yg,11019
14
+ src/literature_relation_service.py,sha256=loKx0CorHhiftPojNLGHPQR3d7_ITq35g45e4vhc1XU,7530
15
+ src/pubmed_search.py,sha256=9ILGkXguzxyBI8WcnC8rUofCfJyaLC5KINY2-djk6pU,28693
16
+ src/reference_service.py,sha256=PFLUkL53rTIe8x9EQMdYCHBCr3_cG6wEq-ixAyiubgs,18652
17
+ src/similar_articles.py,sha256=P_LQbkXPFapTsqmeT_Zsc0kJuWiTSMYK-jtMbxVt60U,11691
18
+ src/resource/journal_info.json,sha256=hOGavYcyn8TRlnXBwCtmbg3YvHzQU_Giic56h9M4Eqo,122739
19
+ tool_modules/article_detail_tools.py,sha256=fU4qcWEqEHb4Nkq4hRd9Mx3dJ9huxk9xlqlm_Ac1Q1U,2789
20
+ tool_modules/quality_tools.py,sha256=SLbEUFxUGTBJD8YOluDkcEXYJsyOJcBVYyZEHhxASiw,4363
21
+ tool_modules/reference_tools.py,sha256=wvGyytuJtjeFMpTq5wqj5XpMM4DOk8whchF15v2yxt8,7673
22
+ tool_modules/relation_tools.py,sha256=qGMvfxrkuIwU4En100gYIR70UzOoljd0urxPcgJ_KDs,8030
23
+ tool_modules/search_tools.py,sha256=OJX58tGS4X-NBPPckS-lIgtq7K460JaQxHKVLOs5UGA,6149
24
+ article_mcp-0.1.0.dist-info/METADATA,sha256=sGWI2omWPoQoBfsl6wQX5Wu7JtkNBRG5G69a6lmXvv0,11700
25
+ article_mcp-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
26
+ article_mcp-0.1.0.dist-info/entry_points.txt,sha256=HOv9osIu8wWlXqqKcdtLX03Mcg4HihEFJSB5oxA3on0,42
27
+ article_mcp-0.1.0.dist-info/top_level.txt,sha256=oz1sq_mZrknAWQdn6oYPmYFz_gg57a9s4eGMIT_TGqc,27
28
+ article_mcp-0.1.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (80.9.0)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ article-mcp = main:main
@@ -0,0 +1,4 @@
1
+ json
2
+ main
3
+ src
4
+ tool_modules
json/mcp_config.json ADDED
@@ -0,0 +1,14 @@
1
+ {
2
+ "mcpServers": {
3
+ "article-mcp": {
4
+ "command": "uvx",
5
+ "args": [
6
+ "article-mcp",
7
+ "server"
8
+ ],
9
+ "env": {
10
+ "PYTHONUNBUFFERED": "1"
11
+ }
12
+ }
13
+ }
14
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "mcpServers": {
3
+ "article-mcp": {
4
+ "command": "uv",
5
+ "args": [
6
+ "run",
7
+ "--directory",
8
+ "D:\\C\\Documents\\Program\\Python_file\\mcp_serve\\mcp1",
9
+ "main.py",
10
+ "server"
11
+ ],
12
+ "env": {
13
+ "PYTHONUNBUFFERED": "1"
14
+ }
15
+ }
16
+ }
17
+ }
@@ -0,0 +1,21 @@
1
+ {
2
+ "mcpServers": {
3
+ "article-mcp": {
4
+ "command": "uv",
5
+ "args": [
6
+ "run",
7
+ "--directory",
8
+ "D:\\C\\Documents\\Program\\Python_file\\mcp_serve\\mcp1",
9
+ "main.py",
10
+ "server",
11
+ "--transport",
12
+ "stdio"
13
+ ],
14
+ "env": {
15
+ "PYTHONUNBUFFERED": "1",
16
+ "UV_LINK_MODE": "copy",
17
+ "PATH": "%PATH%"
18
+ }
19
+ }
20
+ }
21
+ }