Arxiv Paper MCP

🚀 ArXiv Paper MCP

ArXiv Paper MCPは、arXivに基づいた論文検索と内容解析ツールです。Model Context Protocol (MCP) 標準をサポートし、論文検索、PDFリンクの取得、内容解析機能を提供します。

🚀 クイックスタート

ArXiv Paper MCPは、arXiv上の論文を検索し、その内容を解析するための便利なツールです。以下のセクションでは、このツールの機能、インストール方法、使用方法などについて詳しく説明します。

✨ 主な機能

• 🔍 arXiv論文のスマート検索：キーワード検索により、関心のある論文を迅速に見つけることができます。
• 🔗 PDFダウンロードリンクの取得：arXiv論文の直接のPDFダウンロードリンクを取得できます。
• 📄 論文内容の解析：論文内容をスマートに解析し、HTMLバージョンを優先し、PDFにフォールバックします。
• 🆕 AI分野の最新論文：arXivのAI分野で今日最新に更新された論文リストを取得できます。

📦 インストール

NPX方式（推奨）

npx @langgpt/arxiv-paper-mcp

グローバルインストール

npm install -g @langgpt/arxiv-paper-mcp
arxiv-paper-mcp

💻 使用例

MCPクライアントの設定

Claude Desktopの設定

Claude Desktopの設定ファイルに以下を追加します。

{
  "mcpServers": {
    "arxiv-paper-mcp": {
      "command": "npx",
      "args": ["-y", "@langgpt/arxiv-paper-mcp@latest"]
    }
  }
}

設定ファイルの場所：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

その他のMCPクライアント

他のMCP対応クライアントの場合は、そのドキュメントを参照してstdio伝送方式を設定してください。

利用可能なツールとパラメータ

1. 論文の検索

• ツール名: search_arxiv
• パラメータ:
  • query：検索キーワード
  • maxResults：返される論文数（オプション、デフォルトは5）

2. PDFダウンロードリンクの取得

• ツール名: get_arxiv_pdf_url
• パラメータ:
  • input：arXiv論文のURLまたはarXiv ID（例：2403.15137v1）

3. 論文内容の解析

• ツール名: parse_paper_content
• パラメータ:
  • input：arXiv論文のURLまたはarXiv ID
  • paperInfo：論文のメタ情報（オプション、論文のメタデータを追加するため）

4. AI分野の最新論文の取得

• ツール名: get_recent_ai_papers
• パラメータ: なし

使用フローの例

1. 論文の検索 search_arxiv ツールを使用して関連する論文を検索します。
2. 最新のAI論文の取得 get_recent_ai_papers ツールを使用して今日の最新のAI分野の論文を取得します。
3. PDFリンクの取得 get_arxiv_pdf_url ツールを使用してPDFダウンロードリンクを取得します。
4. 論文内容の解析 parse_paper_content ツールを使用して論文のテキスト内容を取得します（HTMLを優先、PDFにフォールバック）。

開発ガイド

ローカル開発

# プロジェクトをクローンする
git clone https://github.com/yzfly/arxiv-paper-mcp.git
cd arxiv-paper-mcp

# 依存関係をインストールする
npm install

# 開発モードで実行する
npm run dev

# ビルドする
npm run build

# ビルド版を実行する
npm start

プロジェクト構造

arxiv-paper-mcp/
├── src/
│   └── index.ts          # メインサーバーファイル
├── build/                # コンパイル出力ディレクトリ
├── package.json          # プロジェクト設定
├── tsconfig.json         # TypeScript設定
├── README.md             # プロジェクト説明
└── LICENSE               # ライセンス

🔧 技術詳細

• Node.js >= 18.0.0
• TypeScript - 型安全なJavaScript
• Model Context Protocol - 標準化されたAIコンテキストプロトコル
• arXiv API - 学術論文のデータソース

📚 ドキュメント

トラブルシューティング

一般的な問題

1. 論文検索が失敗する

   エラー：検索に失敗しました
   解決策：ネットワーク接続を確認し、検索キーワードが正しいことを確認してください。
   

2. PDF解析が失敗する

   エラー：PDF解析に失敗しました
   解決策：arXiv IDが正しいことを確認し、論文が存在することを確認してください。
   

ログデバッグ

詳細ログを有効にするには、以下を実行します。

DEBUG=arxiv-paper-mcp npx @langgpt/arxiv-paper-mcp

貢献ガイド

コードの貢献を歓迎します！以下の手順に従ってください。

1. このプロジェクトをForkします。
2. 機能ブランチを作成します：git checkout -b feature/amazing-feature
3. 変更をコミットします：git commit -m 'Add amazing feature'
4. ブランチをプッシュします：git push origin feature/amazing-feature
5. Pull Requestを作成します。

📄 ライセンス

このプロジェクトはMITライセンスを採用しています。詳細は LICENSE ファイルを参照してください。

作者情報

• 作者: yzfly
• メールアドレス: yz.liu.me@gmail.com
• GitHub: https://github.com/yzfly

関連リンク

• Model Context Protocol
• arXiv.org
• Claude Desktop

サポート

このプロジェクトが役に立った場合は、⭐を付けてください！

問題や提案がある場合は、以下の方法で連絡してください。

• 📧 メール：yz.liu.me@gmail.com
• 🐛 GitHub Issues：プロジェクトの問題追跡
• 💬 GitHub Discussions：プロジェクトのディスカッションエリア