Global Papers MCP 服务器

集成式海外学术论文搜索 MCP 服务器 - 集成了 OpenAlex、Semantic Scholar、CrossRef 和 arXiv API

⚡ 快速开始 (5分钟)

🎯 2种部署方法

方法 1: Railway (最简单 - 推荐！)

仅需推送到 GitHub 即可自动部署！

1. 推送到 GitHub

   cd global-papers-mcp
   git init && git add . && git commit -m "Initial commit"
   git remote add origin https://github.com/YOUR_USERNAME/global-papers-mcp.git
   git push -u origin main

2. 连接 Railway

   • 访问 https://railway.app

   • Sign in with GitHub

   • New Project → Deploy from GitHub repo

   • 选择 global-papers-mcp → Deploy Now

3. 确认域名

   • Settings → Networking → Generate Domain

   • 复制 URL: https://xxx.up.railway.app/mcp

4. 连接 Claude.ai

   • Settings → Connectors → Add Connector

   • 输入 URL → 保存

完成！ 🎉

详细指南: RAILWAY_DEPLOY.md

方法 2: Fly.io (高级用户)

自动部署脚本：

# Mac/Linux
./deploy.sh

# Windows
deploy.bat

详细指南: ONE_CLICK_DEPLOY.md

Related MCP server: Crossref Academic MCP Server

📋 目录

• 快速概览

• 概述

• 主要功能

• 安装与运行

  • 本地运行

  • Fly.io 部署

• Claude MCP 连接器注册

  • 方法 1: Claude.ai 网页/移动端 (推荐)

  • 方法 2: Claude Desktop 应用

  • 连接确认与测试

  • 问题排查

• API 密钥设置

• 使用示例

• 技术栈

• 速率限制

• 参考项目

• 许可证

• 贡献

• 联系方式

🎯 快速概览

在 Claude.ai 中集成搜索 全球 5 亿+ 学术论文 的 MCP 服务器

• 🔍 集成 4 个 API - OpenAlex, Semantic Scholar, CrossRef, arXiv

• 🛠 13 个工具 - 搜索、详情查询、引用追踪、作者/机构信息

• 🚀 5 分钟部署 - Fly.io 东京区域，响应迅速

• 📚 完善的文档 - 提供 11 个指南文档

• ✅ 大部分无需 API 密钥 - OpenAlex, CrossRef, arXiv 可直接使用

概述

这是一个可以在 Claude.ai 中搜索和分析海外学术论文的 MCP (Model Context Protocol) 服务器。 通过集成 4 个主流学术 API，提供全面的论文搜索功能。

支持的 API

1. OpenAlex - 全领域 2.5 亿+ 论文

2. Semantic Scholar - AI/ML 特化 2 亿+ 论文

3. CrossRef - 基于 DOI 的 1.5 亿+ 元数据

4. arXiv - 物理/数学/CS 预印本 240 万+

主要功能

OpenAlex 工具 (4 个)

• openalex_search_papers - 论文搜索

• openalex_get_paper_detail - 论文详情

• openalex_get_author - 作者信息查询

• openalex_search_institutions - 机构搜索

Semantic Scholar 工具 (4 个)

• semantic_search_papers - 论文搜索

• semantic_get_paper_detail - 论文详情

• semantic_get_citations - 引用论文查询

• semantic_get_references - 参考文献查询

CrossRef 工具 (3 个)

• crossref_search_works - 论文搜索

• crossref_get_work_by_doi - 通过 DOI 查询论文

• crossref_search_journals - 期刊搜索

arXiv 工具 (2 个)

• arxiv_search_papers - 论文搜索

• arxiv_get_paper_detail - 论文详情

安装与运行

本地运行

# 1. 저장소 클론
git clone https://github.com/YOUR_USERNAME/global-papers-mcp.git
cd global-papers-mcp

# 2. 의존성 설치
pip install -r requirements.txt

# 3. 환경 변수 설정 (선택)
cp .env.example .env
# .env 파일에서 SEMANTIC_SCHOLAR_API_KEY 설정 (선택사항)

# 4. 로컬 테스트 실행
python server.py

Fly.io 部署

# 1. Fly.io CLI 설치
curl -L https://fly.io/install.sh | sh

# 2. Fly.io 로그인
flyctl auth login

# 3. 앱 생성 (도쿄 리전 사용으로 latency 최소화)
flyctl launch --no-deploy

# 4. 리전을 Tokyo(nrt)로 변경
flyctl regions set nrt

# 5. 배포
flyctl deploy

# 6. API 키 설정 (Semantic Scholar 사용 시)
flyctl secrets set SEMANTIC_SCHOLAR_API_KEY=your_api_key_here

# 7. MCP URL 확인
flyctl info
# URL 예시: https://global-papers-mcp.fly.dev/mcp

Claude MCP 连接器注册

🌐 方法 1: Claude.ai 网页/移动端 (推荐)

这是最简单快捷的方法！

第 1 步：部署 MCP 服务器并确认 URL

首先完成 Fly.io 的部署（参考上述 Fly.io 部署）

# 배포 후 MCP URL 확인
flyctl info

输出示例：

Hostname = global-papers-mcp.fly.dev

MCP URL: https://global-papers-mcp.fly.dev/mcp (末尾必须包含 /mcp！)

第 2 步：访问 Claude.ai

在浏览器中访问 https://claude.ai (或打开移动端 App)

第 3 步：打开设置菜单

网页 (桌面端):

• 点击左下角个人头像 (或名字)

• 选择 Settings (设置)

移动端 (iOS/Android):

• 点击右上角菜单按钮 (≡)

• 选择 Settings (设置)

第 4 步：进入连接器菜单

• 点击 Connectors 或 Integrations 菜单

• 或选择 Features → Model Context Protocol

第 5 步：添加新连接器

点击 Add Connector 或 + Add 按钮

第 6 步：输入 MCP 信息

准确输入以下信息：

⚠️ 重要：URL 末尾必须包含 /mcp！

示例：

• ✅ 正确 URL: https://global-papers-mcp.fly.dev/mcp

• ❌ 错误 URL: https://global-papers-mcp.fly.dev

第 7 步：保存并连接

• 点击 Connect 或 Save 按钮

• 自动执行连接测试

• 确认状态为 "Connected" 或 "Active"

第 8 步：连接确认与测试

在 Connectors 列表中确认：

• Global Papers MCP 显示在列表中

• 状态: 🟢 Connected

实际使用测试：

开始新对话并输入以下指令：

"OpenAlex에서 machine learning 관련 논문 5개 검색해줘"

如果 Claude 返回论文搜索结果，则说明成功！ 🎉

💻 方法 2: Claude Desktop 应用

如果您在本地 PC 上使用 Claude Desktop 应用

选项 A: 使用 Fly.io 部署的 URL (推荐)

1. 找到配置文件位置

   各操作系统路径：

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/claude/claude_desktop_config.json

2. 打开配置文件

   Mac/Linux:

   # 파일이 없으면 생성
   mkdir -p ~/Library/Application\ Support/Claude/
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

   Windows:

   notepad %APPDATA%\Claude\claude_desktop_config.json

3. 添加 MCP 服务器

   输入以下内容或添加到现有文件中：

   {
     "mcpServers": {
       "global-papers": {
         "url": "https://global-papers-mcp.fly.dev/mcp"
       }
     }
   }

   如果使用多个 MCP 服务器：

   {
     "mcpServers": {
       "global-papers": {
         "url": "https://global-papers-mcp.fly.dev/mcp"
       },
       "kci-papers": {
         "url": "https://kci-mcp-korea.fly.dev/mcp"
       }
     }
   }

4. 保存文件并重启 Claude Desktop

   • 保存配置文件 (Ctrl+S 或 Cmd+S)

   • 完全退出 Claude Desktop 应用

   • 重新启动 Claude Desktop

5. 确认连接

   在 Claude Desktop 中开始新对话后：

   "사용 가능한 도구를 보여줘"

   如果显示 Global Papers MCP 工具，则说明成功！

选项 B: 本地运行服务器

仅在本地运行，不使用 Fly.io 的情况

1. 准备本地服务器运行

   cd /path/to/global-papers-mcp
   pip install -r requirements.txt

2. 修改配置文件

   claude_desktop_config.json:

   {
     "mcpServers": {
       "global-papers": {
         "command": "python",
         "args": ["/absolute/path/to/global-papers-mcp/server.py"]
       }
     }
   }

   ⚠️ 注意：

   • 路径必须使用 绝对路径

   • Windows: C:\\Users\\YourName\\global-papers-mcp\\server.py

   • Mac/Linux: /Users/YourName/global-papers-mcp/server.py

3. 重启 Claude Desktop

   保存配置文件后重启应用

4. 自动运行服务器

   启动 Claude Desktop 时会自动启动本地服务器。

🔍 连接确认与测试

确认连接状态

Claude.ai (网页/移动端):

1. Settings → Connectors

2. 确认 Global Papers 状态

   • 🟢 Connected = 正常

   • 🔴 Disconnected = 错误

Claude Desktop:

1. 开始新对话

2. 输入以下指令：

   "연결된 MCP 서버를 보여줘"

功能测试

基础搜索：

"OpenAlex에서 transformer architecture 관련 논문 5개 검색해줘"

DOI 查询：

"CrossRef에서 이 DOI의 논문을 조회해줘: 10.1038/s41586-021-03819-2"

arXiv 搜索：

"arXiv에서 cs.AI 카테고리의 최신 논문 10개 보여줘"

引用关系追踪：

"Semantic Scholar에서 'Attention is All You Need' 논문을 검색하고, 이 논문을 인용한 주요 논문들을 찾아줘"

⚠️ 问题排查

"Connection failed" 错误

原因 1: URL 错误

• 缺少 /mcp 端点

• 解决方法：在 URL 末尾添加 /mcp

原因 2: 服务器未运行

# Fly.io 서버 상태 확인
flyctl status

# 서버가 중지되어 있으면
flyctl apps restart

原因 3: 防火墙拦截

• 公司/学校网络可能拦截了 Fly.io

• 解决方法：尝试其他网络或咨询 IT 部门

工具未显示

Claude.ai:

1. 刷新浏览器

2. 登出后重新登录

3. 尝试其他浏览器

Claude Desktop:

1. 检查配置文件路径

2. 检查 JSON 语法错误 (使用 JSONLint 验证)

3. 完全退出应用后重启

响应速度慢

原因: 区域问题

# 현재 리전 확인
flyctl regions list

# Tokyo(nrt) 리전으로 변경
flyctl regions set nrt
flyctl deploy

📚 更多帮助

• 详细指南: DEPLOYMENT.md

• 问题排查: TROUBLESHOOTING.md

• 使用示例: EXAMPLES.md

• FAQ: FAQ.md

---## API 密钥设置

大多数 API 无需密钥即可使用，但 Semantic Scholar 使用 API 密钥可放宽速率限制。

获取 Semantic Scholar API 密钥

1. 访问 https://www.semanticscholar.org/product/api

2. 点击 "Get API Key" 获取免费密钥

3. 在 .env 文件或环境变量中设置

使用示例

在 Claude.ai 中按如下方式使用：

"transformer 아키텍처 관련 최신 논문을 OpenAlex에서 검색해줘"

"이 DOI의 논문을 CrossRef에서 조회해줘: 10.1038/nature12345"

"arXiv에서 quantum computing 관련 최신 프리프린트 찾아줘"

"Semantic Scholar에서 이 논문을 인용한 논문들을 찾아줘"

技术栈

• FastMCP - MCP 服务器框架

• httpx - 异步 HTTP 客户端

• Python 3.9+

• Fly.io - 部署平台 (东京区域)

速率限制

• OpenAlex: 100,000 次请求/天 (无需 API 密钥)

• Semantic Scholar: 无密钥时 100 次请求/5分钟，使用 API 密钥可放宽

• CrossRef: 使用 polite pool 可获得更快响应

• arXiv: 建议 1 次请求/3秒

参考项目

• kci-mcp-korea - 韩国学术期刊引文索引 (KCI) MCP 服务器

许可证

MIT License

贡献

欢迎提交 Issue 和 PR！

联系方式

• GitHub Issues: https://github.com/YOUR_USERNAME/global-papers-mcp/issues