Skip to main content
Glama
Global Papers MCP

Global Papers MCP

Global Papers MCP 服务器

License: MIT Python 3.11+ FastMCP Fly.io

集成式海外学术论文搜索 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

📋 目录


🎯 快速概览

在 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 信息

准确输入以下信息:

字段

输入内容

Name

Global Papers (自定义名称)

URL

https://your-app-name.fly.dev/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

📚 更多帮助

---## 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!

联系方式

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      An MCP server for searching and downloading academic papers from multiple sources including arXiv, PubMed, bioRxiv, and Sci-Hub, designed for seamless integration with large language models like Claude Desktop.
      57
      3,055 PyPI
      3,133
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A MCP server for academic literature retrieval, aggregating multiple data sources like arXiv, Crossref, OpenAlex, PubMed, and Semantic Scholar to provide search, details, citations, trends, and recommendations.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server for searching and exploring OpenAlex's index of 250M+ scholarly works, authors, institutions, journals, funders, and grants through Claude.
      1
      MIT