Global Papers MCP-Server

Integrierter MCP-Server für die Suche nach internationalen wissenschaftlichen Arbeiten – Integration der APIs von OpenAlex, Semantic Scholar, CrossRef und arXiv

⚡ Schnellstart (5 Minuten)

🎯 2 Bereitstellungsmethoden

Methode 1: Railway (Am einfachsten – empfohlen!)

Automatische Bereitstellung nur durch GitHub-Push!

1. Push zu 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 verbinden

   • Besuchen Sie https://railway.app

   • Sign in with GitHub

   • New Project → Deploy from GitHub repo

   • Wählen Sie global-papers-mcp → Deploy Now

3. Domain überprüfen

   • Settings → Networking → Generate Domain

   • URL kopieren: https://xxx.up.railway.app/mcp

4. Claude.ai verbinden

   • Settings → Connectors → Add Connector

   • URL eingeben → Speichern

Fertig! 🎉

Detaillierte Anleitung: RAILWAY_DEPLOY.md

Methode 2: Fly.io (Für fortgeschrittene Benutzer)

Automatisches Bereitstellungsskript:

# Mac/Linux
./deploy.sh

# Windows
deploy.bat

Detaillierte Anleitung: ONE_CLICK_DEPLOY.md

Related MCP server: Crossref Academic MCP Server

📋 Inhaltsverzeichnis

• Kurzübersicht

• Überblick

• Hauptfunktionen

• Installation und Ausführung

  • Lokale Ausführung

  • Fly.io-Bereitstellung

• Registrierung des Claude MCP-Connectors

  • Methode 1: Claude.ai Web/Mobil (empfohlen)

  • Methode 2: Claude Desktop App

  • Verbindungsprüfung und Test

  • Fehlerbehebung

• API-Schlüssel-Konfiguration

• Anwendungsbeispiele

• Technologie-Stack

• Rate Limits

• Referenzprojekte

• Lizenz

• Mitwirkung

• Kontakt

🎯 Kurzübersicht

Ein MCP-Server für Claude.ai zur integrierten Suche in über 500 Millionen wissenschaftlichen Arbeiten weltweit

• 🔍 4 APIs integriert - OpenAlex, Semantic Scholar, CrossRef, arXiv

• 🛠 13 Tools - Suche, Detailansicht, Zitationsverfolgung, Autoren-/Institutionsinformationen

• 🚀 5-Minuten-Bereitstellung - Schnelle Antwortzeiten durch Fly.io Tokyo-Region

• 📚 Vollständige Dokumentation - 11 Leitfäden verfügbar

• ✅ API-Schlüssel meist nicht erforderlich - OpenAlex, CrossRef und arXiv sind sofort einsatzbereit

Überblick

Dies ist ein MCP-Server (Model Context Protocol), mit dem Sie in Claude.ai nach internationalen wissenschaftlichen Arbeiten suchen und diese analysieren können. Er integriert vier wichtige wissenschaftliche APIs, um eine umfassende Suchfunktion für Forschungsarbeiten zu bieten.

Unterstützte APIs

1. OpenAlex - Über 250 Millionen Arbeiten aus allen Fachbereichen

2. Semantic Scholar - Über 200 Millionen Arbeiten mit Schwerpunkt auf KI/ML

3. CrossRef - Über 150 Millionen Metadaten basierend auf DOI

4. arXiv - Über 2,4 Millionen Preprints aus Physik/Mathematik/Informatik

Hauptfunktionen

OpenAlex Tools (4)

• openalex_search_papers - Suche nach Arbeiten

• openalex_get_paper_detail - Details zu einer Arbeit

• openalex_get_author - Autoreninformationen abrufen

• openalex_search_institutions - Suche nach Institutionen

Semantic Scholar Tools (4)

• semantic_search_papers - Suche nach Arbeiten

• semantic_get_paper_detail - Details zu einer Arbeit

• semantic_get_citations - Zitierte Arbeiten abrufen

• semantic_get_references - Referenzen abrufen

CrossRef Tools (3)

• crossref_search_works - Suche nach Arbeiten

• crossref_get_work_by_doi - Arbeit per DOI abrufen

• crossref_search_journals - Suche nach Fachzeitschriften

arXiv Tools (2)

• arxiv_search_papers - Suche nach Arbeiten

• arxiv_get_paper_detail - Details zu einer Arbeit

Installation und Ausführung

Lokale Ausführung

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

# 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

Registrierung des Claude MCP-Connectors

🌐 Methode 1: Claude.ai Web/Mobil (empfohlen)

Die einfachste und schnellste Methode!

Schritt 1: MCP-Server bereitstellen und URL bestätigen

Schließen Sie zuerst die Bereitstellung auf Fly.io ab (siehe Fly.io-Bereitstellung oben).

# 배포 후 MCP URL 확인
flyctl info

Beispielausgabe:

Hostname = global-papers-mcp.fly.dev

MCP-URL: https://global-papers-mcp.fly.dev/mcp (Das /mcp am Ende ist erforderlich!)

Schritt 2: Claude.ai aufrufen

Besuchen Sie https://claude.ai in Ihrem Webbrowser (oder öffnen Sie die mobile App).

Schritt 3: Einstellungsmenü öffnen

Web (Desktop):

• Klicken Sie unten links auf das Profilsymbol (oder Ihren Namen).

• Wählen Sie Settings (Einstellungen).

Mobil (iOS/Android):

• Tippen Sie auf das Menüsymbol (≡) oben rechts.

• Wählen Sie Settings (Einstellungen).

Schritt 4: Zum Connector-Menü navigieren

• Klicken Sie auf das Menü Connectors oder Integrations.

• Oder wählen Sie Features → Model Context Protocol.

Schritt 5: Neuen Connector hinzufügen

Klicken Sie auf die Schaltfläche Add Connector oder + Add.

Schritt 6: MCP-Informationen eingeben

Geben Sie die folgenden Informationen genau ein:

⚠️ Wichtig: Das /mcp am Ende der URL muss enthalten sein!

Beispiel:

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

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

Schritt 7: Speichern und verbinden

• Klicken Sie auf die Schaltfläche Connect oder Save.

• Der Verbindungstest wird automatisch ausgeführt.

• Überprüfen Sie, ob der Status "Connected" oder "Active" angezeigt wird.

Schritt 8: Verbindungsprüfung und Test

Überprüfung in der Connector-Liste:

• Global Papers MCP wird in der Liste angezeigt.

• Status: 🟢 Connected

Praktischer Test:

Starten Sie eine neue Unterhaltung und geben Sie den folgenden Befehl ein:

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

Wenn Claude Suchergebnisse für wissenschaftliche Arbeiten zurückgibt, war der Vorgang erfolgreich! 🎉

💻 Methode 2: Claude Desktop App

Wenn Sie die Claude Desktop App auf Ihrem lokalen PC verwenden

Option A: Fly.io-Bereitstellungs-URL verwenden (empfohlen)

1. Speicherort der Konfigurationsdatei finden

   Pfade je nach Betriebssystem:

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

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

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

2. Konfigurationsdatei öffnen

   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-Server hinzufügen

   Geben Sie den folgenden Inhalt ein oder fügen Sie ihn der bestehenden Datei hinzu:

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

   Wenn Sie mehrere MCP-Server verwenden:

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

4. Datei speichern und Claude Desktop neu starten

   • Konfigurationsdatei speichern (Strg+S oder Cmd+S)

   • Claude Desktop App vollständig beenden

   • Claude Desktop erneut starten

5. Verbindung prüfen

   Nach dem Start einer neuen Unterhaltung in Claude Desktop:

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

   Wenn die Global Papers MCP-Tools angezeigt werden, war der Vorgang erfolgreich!

Option B: Lokale Serverausführung

Wenn Sie den Server nur lokal ohne Fly.io ausführen

1. Vorbereitung der lokalen Serverausführung

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

2. Konfigurationsdatei anpassen

   claude_desktop_config.json:

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

   ⚠️ Achtung:

   • Der Pfad muss ein absoluter Pfad sein.

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

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

3. Claude Desktop neu starten

   Nach dem Speichern der Konfigurationsdatei die App neu starten.

4. Automatischer Serverstart

   Der lokale Server wird automatisch gestartet, wenn Claude Desktop ausgeführt wird.

🔍 Verbindungsprüfung und Test

Verbindungsstatus prüfen

Claude.ai (Web/Mobil):

1. Settings → Connectors

2. Status von Global Papers prüfen

   • 🟢 Connected = Normal

   • 🔴 Disconnected = Fehler

Claude Desktop:

1. Neue Unterhaltung starten

2. Folgenden Befehl eingeben:

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

Funktionstest

Grundlegende Suche:

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

DOI-Abfrage:

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

arXiv-Suche:

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

Zitationsbeziehungen verfolgen:

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

⚠️ Fehlerbehebung

Fehler "Connection failed"

Ursache 1: URL-Fehler

• /mcp-Endpunkt fehlt

• Lösung: /mcp am Ende der URL hinzufügen

Ursache 2: Server läuft nicht

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

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

Ursache 3: Firewall-Blockierung

• Fly.io könnte in Firmen-/Schulnetzwerken blockiert sein

• Lösung: Anderes Netzwerk versuchen oder IT-Abteilung kontaktieren

Tools werden nicht angezeigt

Claude.ai:

1. Browser neu laden

2. Abmelden und erneut anmelden

3. Anderen Browser versuchen

Claude Desktop:

1. Pfad der Konfigurationsdatei prüfen

2. JSON-Syntax prüfen (Validierung über JSONLint)

3. App vollständig beenden und neu starten

Langsame Antwortzeiten

Ursache: Region-Problem

# 현재 리전 확인
flyctl regions list

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

📚 Zusätzliche Hilfe

• Detaillierte Anleitung: DEPLOYMENT.md

• Fehlerbehebung: TROUBLESHOOTING.md

• Anwendungsbeispiele: EXAMPLES.md

• FAQ: FAQ.md

API-Schlüssel-Konfiguration

Die meisten APIs können ohne Schlüssel verwendet werden, jedoch wird bei Semantic Scholar das Rate Limit bei Verwendung eines API-Schlüssels gelockert.

Semantic Scholar API-Schlüssel beantragen

1. Besuchen Sie https://www.semanticscholar.org/product/api

2. Klicken Sie auf "Get API Key", um einen kostenlosen Schlüssel zu erhalten

3. In der .env-Datei oder als Umgebungsvariable konfigurieren

Anwendungsbeispiele

Verwendung in Claude.ai wie folgt:

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

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

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

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

Technologie-Stack

• FastMCP - MCP-Server-Framework

• httpx - Asynchroner HTTP-Client

• Python 3.9+

• Fly.io - Bereitstellungsplattform (Tokyo-Region)

Rate Limits

• OpenAlex: 100.000 Anfragen/Tag (kein API-Schlüssel erforderlich)

• Semantic Scholar: 100 Anfragen/5 Min. ohne API-Schlüssel, gelockert mit API-Schlüssel

• CrossRef: Schnellere Antwortzeiten bei Verwendung des "polite pool"

• arXiv: 1 Anfrage/3 Sek. empfohlen

Referenzprojekte

• kci-mcp-korea - KCI (Korean Citation Index) MCP-Server

Lizenz

MIT License

Mitwirkung

Issues und PRs sind willkommen!

Kontakt

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