arXiv Research MCP

科学文献リサーチ用の、読み取り専用でデプロイ可能なMCPサーバー。

ChatGPT
   ↓  Streamable HTTP
arXiv Research MCP
   ↓  official Atom API
arXiv scientific papers

このサーバーはメタデータを取得して正規化します。物理学の説明、論文の比較、方程式を解く作業は引き続きChatGPTが担当します。

ツール

すべてのツールは読み取り専用に設定されており、arXiv ID、正規化されたタイトルと要約、著者、カテゴリ、日付、DOI、ジャーナル参照情報、要約のURL、利用可能な場合はPDFのURLを含む型付き構造化データを返します。

ローカルセットアップ

Python 3.11以降が必要です。

py -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
Copy-Item .env.example .env

.env の ARXIV_USER_AGENT を編集し、サンプルの連絡先を自分のメールアドレスまたはプロジェクトのURLに置き換えてください。arXivはAPIキーを必要としません。

stdio経由でローカル実行するには：

arxiv-mcp

リモート互換トランスポートをローカルで実行するには：

arxiv-mcp --transport streamable-http --host 127.0.0.1 --port 8000

エンドポイントは次のとおりです：

http://127.0.0.1:8000/mcp
http://127.0.0.1:8000/health

手動でのツールテストには、HTTPサーバーを起動し、公式のMCP Inspectorを実行して、http://127.0.0.1:8000/mcp に接続します：

npx @modelcontextprotocol/inspector@latest

テストの実行

pytest
ruff check .

テストはモック化されたHTTPレスポンスを使用するため、arXiv APIを消費しません。GitHub Actionsは、プッシュとプルリクエストのたびに同じチェックを実行します。

信頼性とセキュリティ

• 許可リストに登録された固定アップストリーム： https://export.arxiv.org/api/query

• デフォルトで3秒のグローバルリクエスト間隔

• タイムアウト、ネットワーク障害、HTTP 429、一時的な5xxレスポンスに対する回数制限付きリトライ

• 結果数、オフセット、カテゴリ、ソート、arXiv IDの厳格な検証

• 外部エンティティを無効にした安全なXML解析

• シェル実行、任意のURL取得、シークレット、書き込み操作、ユーザーデータの保存は一切行いません

• ステートレスなStreamable HTTPデプロイメント

Renderへのデプロイ

リポジトリには、非rootの Dockerfile と render.yaml Blueprintが含まれています。

1. このリポジトリをGitHubにプッシュします。

2. Renderにサインインし、新規 → Blueprint を選択します。

3. GitHubリポジトリを接続し、render.yaml を適用します。

4. Renderサービスの環境で、ARXIV_USER_AGENT が実際の連絡先メールアドレスまたはリポジトリのURLを含むように変更します。

5. /health が成功するまで待ち、サービスURLをコピーします。

最終的なMCP URLは次のとおりです：

https://<your-render-service>.onrender.com/mcp

BlueprintはRenderの無料インスタンスを使用するため、デプロイしても自動的に課金が発生することはありません。Renderのドキュメントによると、無料サービスは15分間アクティビティがないとスリープし、再起動に約1分かかることがあります。このコールドスタートはMCPクライアントのタイムアウトを超える可能性があります。常時利用可能な本番用コネクタとして利用する前に、サービスを starter または他の有料インスタンスにアップグレードしてください。Renderの無料枠の制限 と Blueprintリファレンス を参照してください。

ChatGPTに接続する

以下の手順は、現在のOpenAI公式ドキュメントに従っています：

1. サーバーをデプロイし、公開HTTPSの /mcp URLがMCP Inspectorで動作することを確認します。

2. ChatGPTで、設定 → セキュリティとログイン を開き、デベロッパーモード を有効にします。

3. ChatGPT Plugins を開き、プラスボタンを選択します。

4. 次のように入力します：

   • 名前： arXiv Research

   • 説明： Read-only search and metadata retrieval from the official arXiv API.

   • 接続： 公開MCPエンドポイント

   • サーバーURL： https://<your-render-service>.onrender.com/mcp

   • 認証： なし

5. 接続を作成し、ツールがちょうど5つ検出されることを確認します。

6. 新しいチャットを開始し、ツールメニューから arXiv Research を追加します。

OpenAIは現在、公開HTTPSエンドポイント（またはSecure MCP Tunnel）とStreamable HTTPを必要とし、通常は /mcp をエンドポイントとします。デベロッパーモードが利用できるかどうかは、アカウントとワークスペースのポリシーによって異なります。OpenAIの現在のページでは、すべてのChatGPTプランで利用できるとは保証されていないため、お使いのアカウントにデベロッパーモードのトグルが表示されるかどうかが確実な確認方法です。Plusアカウントに表示されない場合でも、このサーバーはMCP Inspector、別のMCPクライアント、またはOpenAI API Playgroundを通じて使用できます。OpenAIの現在の接続ガイド と MCPサーバーガイド を参照してください。

ChatGPTプロンプトの例

• Search arXiv for recent quantum gravity papers.

• Find papers about the Bondi-Sachs formalism.

• Search hep-th for path integral approaches to gravity.

• Find papers by Roger Penrose related to general relativity.

• Get the metadata and PDF link for arXiv:2401.12345.

プロジェクト構造

.
├── src/arxiv_mcp/
│   ├── arxiv_client.py
│   ├── config.py
│   ├── models.py
│   └── server.py
├── tests/
├── .github/workflows/ci.yml
├── .env.example
├── Dockerfile
├── render.yaml
├── pyproject.toml
└── README.md

MITライセンス。