Crossref Cite MCP

🚀 Crossref Cite MCP Server

このサーバーは、Model Context Protocol (MCP) を使用し、Crossref API を通じて論文の引用を解決します。CSL-JSON、BibTeX、RIS、および整形済みテキストなど、複数の出力形式をサポートしています。Claude Desktop、Cursor などのLLMツール向けに設計されています。

日本語以外の言語のドキュメント

✨ 主な機能

• 🔍 スマートな入力解析：DOI、arXiv ID、PMID を自動検出し、それ以外の場合は書誌検索にフォールバックします。
• 📚 複数の引用形式：CSL-JSON、BibTeX、RIS、および整形済みテキスト（APA、Chicago、IEEE など）をサポートします。
• ⚡ 内蔵キャッシュ：メモリまたはJSONファイルキャッシュを使用し、TTL を設定可能（デフォルト: 14日）です。
• 🔄 リトライロジック：レート制限（429）とサーバーエラー（5xx）に対して指数バックオフを使用します。
• 🎯 Polite Pool サポート：mailto パラメータを使用して、Crossref のレート制限を緩和します。

📦 インストール

PyPI からのインストール（推奨）

# uv を使用する場合（推奨）
uv pip install crossref-cite-mcp

# または pip を使用する場合
pip install crossref-cite-mcp

ソースからのインストール（開発用）

# リポジトリをクローンする
git clone https://github.com/h-lu/crossref-cite-mcp.git
cd crossref-cite-mcp

# uv でインストールする
uv pip install -e .

# または pip を使用する
pip install -e .

📚 ドキュメント

設定

環境変数を設定するか、.env ファイルを作成します。

# 必須: Crossref の Polite Pool 用のメールアドレス
export CROSSREF_MAILTO=your-email@example.com

# オプション: キャッシュ設定
export CROSSREF_CACHE_BACKEND=json        # "memory" または "json"
export CROSSREF_CACHE_PATH=~/.crossref-cite/cache.json
export CROSSREF_CACHE_TTL=1209600         # 14日を秒に換算

# オプション: ログ設定
export LOG_LEVEL=INFO

Claude Desktop の設定

macOS の場合、~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

uvx を使用する場合（推奨、事前インストール不要）

{
  "mcpServers": {
    "crossref-cite": {
      "command": "uvx",
      "args": ["crossref-cite-mcp"],
      "env": {
        "CROSSREF_MAILTO": "your-email@example.com"
      }
    }
  }
}

pip でインストールしたパッケージを使用する場合

{
  "mcpServers": {
    "crossref-cite": {
      "command": "crossref-cite-mcp",
      "args": [],
      "env": {
        "CROSSREF_MAILTO": "your-email@example.com"
      }
    }
  }
}

開発用（ソースから uv を使用する場合）

{
  "mcpServers": {
    "crossref-cite": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/crossref-cite-mcp", "python", "-m", "crossref_cite"],
      "env": {
        "CROSSREF_MAILTO": "your-email@example.com"
      }
    }
  }
}

💻 使用例

利用可能なツール

resolve_citation

論文を解決し、複数の形式で引用を返します。

引数:

• query（必須）: 論文のタイトル、DOI、arXiv ID、または PMID
• formats: 形式のリスト (["csl-json", "bibtex", "ris", "formatted"])
• style: 整形済み出力の CSL スタイル（デフォルト: "apa"）
• locale: 整形済み出力のロケール（デフォルト: "en-US"）
• rows: Crossref の候補数（デフォルト: 5）

例:

{
  "query": "Attention Is All You Need",
  "formats": ["bibtex", "formatted"],
  "style": "apa"
}

search_papers

Crossref で論文を検索します（メタデータのみ、引用の取得は行いません）。

引数:

• query（必須）: 検索クエリ
• rows: 結果の数（デフォルト: 10、最大: 20）
• filter_from_year: 出版年フィルタ（開始）
• filter_to_year: 出版年フィルタ（終了）
• filter_type: 作品タイプフィルタ（例: "journal-article"）

直接 CLI でテストする

# JSON-RPC リクエストでテストする
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"resolve_citation","arguments":{"query":"10.1038/nature12373","formats":["bibtex"]}}}' | python -m crossref_cite

🔧 技術詳細

開発

# 開発用の依存関係をインストールする
pip install -e ".[dev]"

# テストを実行する
pytest tests/ -v

# カバレッジを含めてテストを実行する
pytest tests/ -v --cov=crossref_cite

# コードを検査する
ruff check src tests

# 型チェックを実行する
mypy src/crossref_cite

VCR カセットの記録

テスト用の新しい HTTP インタラクションカセットを記録するには、次のコマンドを実行します。

# 既存のカセットを削除し、新しく記録する
rm -rf tests/cassettes/
pytest tests/ -v --vcr-record=new_episodes

Docker

# イメージをビルドする
docker build -t crossref-cite-mcp .

# コンテナを実行する
docker run -e CROSSREF_MAILTO=your-email@example.com crossref-cite-mcp

API リファレンス

Crossref のベストプラクティス

この実装は、Crossref REST API のベストプラクティスに従っています。

• ✅ mailto パラメータを使用して Polite Pool にアクセスします。
• ✅ レート制限に対して指数バックオフを実装しています。
• ✅ 結果をキャッシュして、冗長なリクエストを削減します。
• ✅ 引用のような検索に query.bibliographic を使用します。

コンテンツネゴシエーション

引用形式は、DOI コンテンツネゴシエーションを通じて取得されます。

📄 ライセンス

MIT