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 Web/モバイル (推奨)

  • 方法2: Claude Desktopアプリ

  • 接続確認とテスト

  • トラブルシューティング

• APIキーの設定

• 使用例

• 技術スタック

• レート制限

• 参考プロジェクト

• ライセンス

• 貢献

• お問い合わせ

🎯 クイック概要

Claude.aiで世界中の5億件以上の学術論文を統合検索するMCPサーバー

• 🔍 4つのAPIを統合 - OpenAlex, Semantic Scholar, CrossRef, arXiv

• 🛠 13個のツール - 検索、詳細取得、引用追跡、著者/機関情報

• 🚀 5分でデプロイ - Fly.io Tokyoリージョンで高速応答

• 📚 完璧なドキュメント - 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 Web/モバイル (推奨)

最も簡単で迅速な方法です!

ステップ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にアクセス

Webブラウザで https://claude.ai にアクセス (またはモバイルアプリを起動)

ステップ3: 設定メニューを開く

Web (デスクトップ):

• 左下のプロフィールアイコン (または自分の名前) をクリック

• 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アプリを使用する場合

Option A: Fly.ioデプロイURLを使用 (推奨)

1. 設定ファイルの場所を確認

   OS別のパス:

   • 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ツールが表示されれば成功!

Option 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 (Web/モバイル):

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 - デプロイプラットフォーム (Tokyoリージョン)

レート制限

• OpenAlex: 100,000リクエスト/日 (APIキー不要)

• Semantic Scholar: APIキーなしで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