CiteNexus

CiteNexus MCP

追跡可能な根拠に基づく学術文献の発見と引用。

CiteNexus は、Model Context Protocol を通じて、リサーチアシスタントをオープンな学術メタデータ、専門分野の学術インデックス、オプションの商用データベースに接続します。API キーなしで検索し、永続的な識別子を解決し、参照文献をその出典と照合し、不足している項目を言語モデルに捏造させることなく引用情報をエクスポートできます。

CiteNexus は、すでにお使いのアシスタント向けの引用・メタデータサービスです。Zotero などの文献管理ツールや、MCP に対応した執筆環境と併用できます。

CiteNexus 0.2.3 には MCP サービスと、コンパニオンの cite-nexus-wtfp が含まれています。 WTF-P 統合は、別途リリースされる 0.7.0 を対象としています。マーケットプレイスへの掲載や、ネイティブクライアントプラグインとしての認定は、それぞれ独立して管理されています。

クイックスタート · WTF-P 統合 · プロバイダーガイド · トラブルシューティング · リリース情報

• 認証情報なしでも便利： Crossref、DataCite、Europe PMC がデフォルトの検索ソースです。 arXiv と Semantic Scholar も、必須のキーなしで利用できます。
• オプションの専門分野・商用サービスへのアクセス： OpenAlex、SerpAPI または SearchApi 経由の Google Scholar、Scopus、Web of Science Starter は、明示的な設定とプロバイダーの選択に対応しています。
• 出典に裏付けられたレコード： 名前空間付き識別子、取得時刻、フィールドの出典、不完全な著者情報に関する警告、プロバイダー固有の引用数を提供します。
• 決定的なエクスポート： 取得したメタデータから BibTeX、RIS、CSL-JSON を生成します。モデルは不要です。
• 最新の MCP： Python SDK 2.2、2026-07-28 仕様、構造化ツール結果、リソース、プロンプト、進捗通知、stdio、Streamable HTTP に対応しています。以前のクライアントも、SDK のレガシープロトコル経路を通じて引き続きサポートされます。

クイックスタート

Python 3.11+ と uv が必要です。

uvx --from cite-nexus-mcp==0.2.3 cite-nexus-mcp --version
uvx --from cite-nexus-mcp==0.2.3 cite-nexus-mcp --no-env-file --list-providers

mcpServers 設定を使用する MCP クライアントの場合：

{
  "mcpServers": {
    "cite-nexus": {
      "command": "uvx",
      "args": ["--from", "cite-nexus-mcp==0.2.3", "cite-nexus-mcp", "--no-env-file"]
    }
  }
}

クライアントは stdio 経由で MCP を起動します。API キーや .env ファイルは不要です。サーバーコマンドを直接実行すると、クライアントの接続を待ちます。対話型の検索シェルではありません。クライアントが uvx を見つけられない場合は、実行ファイルの絶対パスを指定してください。初回の実行時に、パッケージとその依存関係がダウンロードされます。

WTF-P コンパニオンを含む、永続的なインストールの場合：

uv tool install cite-nexus-mcp==0.2.3
cite-nexus-wtfp --check

診断では、実際の MCP サービスを起動し、ベンダー API を呼び出さずにプロバイダーを一覧表示します。別途必要な統合と実行ファイルパスの設定については、WTF-P のセットアップを参照してください。

ローカルの HTTP クライアントの場合：

uvx --from cite-nexus-mcp==0.2.3 cite-nexus-mcp --no-env-file --transport streamable-http --port 8000

http://127.0.0.1:8000/mcp に接続してください。CLI はループバックインターフェースにのみバインドし、単一の信頼境界でサービスを提供します。公開されたマルチユーザー環境へのデプロイには、認証、認証情報の分離、独自のデプロイ統合が必要です。CLI はこれらの機能を提供しません。

ソースとアクセス

プロバイダー ID	対象範囲	アクセス	設定
crossref	出版社が登録した DOI メタデータと引用数	無料・デフォルト	丁寧な利用者向けのプールを使用する場合は CITE_NEXUS_CONTACT_EMAIL を設定（任意）
datacite	データセット、ソフトウェア、その他の DOI 登録済み研究成果	無料・デフォルト	なし
europe_pmc	生物医学文献、PubMed／PMC レコード、参考文献、引用	無料・デフォルト	なし
arxiv	物理学、数学、コンピューティングなどの分野のプレプリント	無料	明示的に選択してください。リクエストは 3 秒に 1 回に制限されています
semantic_scholar	Academic Graph の検索と引用のたどり	無料／匿名利用では共有制限あり。キーは任意	SEMANTIC_SCHOLAR_API_KEY（任意）
openalex	学際的な研究グラフ	無料クレジット／従量制アカウントアクセス	OPENALEX_API_KEY
serpapi	SerpAPI ベンダー API 経由の Google Scholar	商用。アカウントの利用枠は異なります	SERPAPI_API_KEY
searchapi	SearchApi.io ベンダー API 経由の Google Scholar	商用。アカウントの利用枠は異なります	SEARCHAPI_API_KEY
scopus	Elsevier が編集する文献インデックス	機関向け／商用の利用資格が必要	SCOPUS_API_KEY。SCOPUS_INSTTOKEN は任意
wos	Clarivate Web of Science Starter	機関向け／商用の利用資格が必要	WOS_API_KEY

find-open-access は、UNPAYWALL_EMAIL が設定されている場合、Unpaywall を使って DOI レコードを補完することもできます。報告されている合法的な OA 公開場所とライセンス情報を返します。PDF のダウンロードやアクセス制限の回避は行いません。

無料アクセスには、各プロバイダーのレート制限と利用規約が適用されます。Semantic Scholar の匿名利用は、大幅に制限される場合があります。OpenAlex のアクセス方針はこれまでに変更されており、匿名リクエストが成功する場合でも、CiteNexus ではこのアダプターにキーを必須としています。機関キーを設定しても、それだけで購読アクセスや機関ネットワーク外からのアクセスが保証されるわけではありません。

商用および従量制のアダプターは、明示的に選択した場合、独自の名前空間付き ID を解決する場合、または検索のデフォルトとして意図的に設定した場合にのみ呼び出されます。キーを設定しただけでは、ベンダーがデフォルトの検索に追加されることはありません。list-providers は、アクセスをテストしたりキーの値を明かしたりせずに、設定、機能、ドキュメントへのリンクを報告します。

研究ワークフロー

CiteNexus を使って文献候補を絞り込んだり、不確かな参考文献を修正したり、引用数の根拠となる情報源を確認したり、執筆ツール用の参考文献一覧を準備したりできます。執筆ワークフロー全体については、WTF-P companion が文献の探索からエビデンステーブル、アウトライン、原稿の作成までをつなぎ、候補となる参考文献を確認できる状態に保ちます。

アシスタントにツールを直接使うよう依頼するか、literature-review および bibliography-audit MCP プロンプトから始めてください。ツール引数の例：

{"query": "reproducible machine learning benchmarks", "providers": ["crossref", "arxiv"], "limit": 5}

{"identifier": "10.1038/nature14539", "format": "bibtex"}

{"citation": "10.1038/nature14539", "expected_title": "Deep learning", "expected_year": 2015}

{"identifier": "PMID:26017442", "direction": "references", "provider": "europe_pmc", "limit": 10}

{"identifiers": ["10.1038/nature14539", "arxiv:1706.03762"], "format": "csl-json"}

ツール	目的
list-providers	情報源の機能、アクセス階層、認証情報の設定を確認します
search-papers	複数の情報源を横断した並行検索、慎重な重複排除、情報源ごとのページネーションを行います
resolve-paper	DOI または名前空間付き識別子を取得して検証します。必要に応じて選択した情報源を統合できます
get-citation	解決済みレコードを bibtex、ris、または csl-json としてエクスポートします
verify-citation	識別子または単一の BibTeX エントリを検証します。指定されたタイトルと発行年も確認します
batch-citations	1～20 件の識別子を解決してエクスポートします。順序付きの結果、一部の失敗、進捗に対応します
related-papers	情報源の引用文献または参考文献をページ単位で取得します
paper-metrics	情報源およびインデックスごとに分けて、確認された引用数を返します
find-open-access	情報源が報告する OA の掲載場所を検索します。必要に応じて Unpaywall の情報を追加できます
enhance-citation	指定された書誌情報を保持したまま、BibTeX の書式を標準化します
find-scholar-id	SerpAPI または SearchApi を通じて従来の Scholar 検索を行い、確認用の候補を返します

search-papers は、全体で 10 件ではなく、プロバイダーごとにデフォルトで 10 件を返します。各プロバイダーのランキングを交互に並べた後、統合可能なレコードをまとめます。limit は 1～50 です。ただし、SerpAPI または SearchApi の使用時は最大 20 件です。各プロバイダーの next_offsets を同じ limitで使用し、次の呼び出しではそのプロバイダーを選択してください。Europe PMC の検索では代わりに next_cursors を使用します。トークンを cursor として渡し、europe_pmc のみを選択し、同じクエリと limit を維持して、offset はゼロのままにしてください。 オフセットは limit の倍数とし、上限は 10,000 です。year_from、year_to、open_access_only は取得したページを絞り込みます。不明な値は除外されます。デフォルトでは検索結果にアブストラクトは含まれません。取得するには include_abstract: true を設定するか、レコードを解決してください。 デフォルトでは検索レコードは簡潔な形式です。sources にはすべてのプロバイダーが引き続き記載されますが、field_sources は空です。フィールドごとの出典情報を確認するには、detail: "full" を設定するか、レコードを解決してください。 プロバイダーごとに検索言語は異なります。明示的な高度なクエリでは、そのプロバイダーの構文を使用してください。

対応する識別子には、10.1038/nature14539、arxiv:1706.03762、PMID:26017442、 PMC12345、openalex:W2919115771、s2:<paperId>、s2:CorpusId:<number>、 scholar:<numericClusterId>、scopus:<numericId>、WOS:<recordId> などがあります。DOI、arXiv、PubMed の URL は認識されます。任意の URL は取得されません。また、接頭辞のない数値文字列が PubMed ID または Scholar ID として扱われることはありません。

DOI の解決では、該当するレコードが取得されるまで Crossref、DataCite、Europe PMC の順に試行します。providers リストを明示した場合は、選択した互換性のある各情報源を確認し、根拠と相違点を保持します。ネイティブ識別子は対応する情報源に振り分けられます。タイトル検索では常に候補が返され、最初の結果が一致すると暗黙に判定されることはありません。

機械から参照できるガイダンスについては、MCP リソース cite-nexus://methodology、cite-nexus://providers、cite-nexus://workflows を参照してください。

「検証済み」の意味

検証では、取得したメタデータに識別子が存在することを確認し、指定されたタイトルと出版年も照合します。**論文の知見が正しいこと、すべての著者が含まれていること、論文が特定の主張を裏付けていること、または撤回されていないことを確認するものではありません。**プロバイダーが停止している場合は、引用が捏造されたと判断するのではなく、unavailable を返します。

エクスポートには、利用できないメタデータは含まれません。著者リストが不完全な場合は警告が生成され、BibTeXでは適切に others が使用されます。引用数にはその出典、インデックス、観測タイムスタンプが保持され、データベースをまたいで合算されることはありません。異なるプロバイダーの引用数は、直接比較できるものではありません。メタデータには誤りや、出版年の矛盾が含まれる場合があります。また、撤回フラグがないからといって、論文が撤回されていない証拠にはなりません。

CSL-JSONは、構造化された書誌データです。APA、IEEE、または各ジャーナル独自のスタイルで表示するには、CSLプロセッサまたは文献管理ツールを使用してください。enhance-citation が対応する書式は default と compact です。キーワード、賞、インパクトファクター、または欠落している著者を推測することはありません。

設定

オプション設定が必要な場合にのみ、.env.example を .env にコピーしてください。既存のプロセス環境変数が優先されます。CLIは ./.env または明示的に指定した --env-file を読み込みます。親ディレクトリを検索することはありません。Pythonパッケージをインポートしても、.env の読み込みや外部サービスの呼び出しは行われません。クライアントが認証情報を独自に管理する場合は、--no-env-file を指定してください。WTF-Pコンパニオンとプラグインマニフェストは、常にこのモードを使用します。

変数	デフォルト	意味
CITE_NEXUS_DEFAULT_PROVIDERS	crossref,datacite,europe_pmc	明示的に指定する検索ソースID。カンマ区切りです
CITE_NEXUS_TIMEOUT	12	各HTTPリクエストのタイムアウト秒数
CITE_NEXUS_OPERATION_TIMEOUT	40	プロバイダー操作または識別子解決に割り当てる時間
CITE_NEXUS_RETRIES	1	トランスポート障害、HTTP 429、5xxレスポンスに対する再試行回数
CITE_NEXUS_CONCURRENCY	6	同時に実行するアウトバウンドリクエストの最大数
CITE_NEXUS_CACHE_TTL	300	プロセス内レスポンスキャッシュの有効期間（秒）。0 にすると無効になります
CITE_NEXUS_CACHE_SIZE	256	キャッシュするレスポンスの最大数。0 にするとキャッシュが無効になります

キャッシュされたレコードには、元の取得タイムスタンプと引用観測タイムスタンプが保持されます。キャッシュには上限があり、認証情報ごとにレスポンスが分離されます。8 MBを超えるレスポンスは拒否されます。Retry-After によるクールダウンが長い場合は、呼び出しを保留せず、プロバイダーの問題として返します。キーと上流からのエラーボディはツールのエラーに含まれません。ローカルの標準エラー出力へのログ記録により、MCP用の標準出力はクリーンに保たれます。

アクセスに関する注意点と制限については、プロバイダーの詳細、移行に関する注意事項、製品の方針をご覧ください。

開発と検証

ソースから作業するには、次のコマンドを実行します。

git clone https://github.com/akougkas/cite-nexus-mcp.git
cd cite-nexus-mcp
uv sync --locked
uv run ruff check src tests scripts
uv run ruff format --check src tests scripts
uv run mypy src/cite_nexus_mcp
uv run python scripts/prepare_release.py --check
uv run python scripts/marketplaces.py --check
uv run pytest -q
uv build

自動テストスイートでは、合成プロバイダーフィクスチャとモック HTTP に加え、実際のローカル stdio プロセスおよび Streamable HTTP プロセスを使用します。ベンダーの認証情報は不要で、テストプロセスからの外部ネットワークアクセスは遮断されます。有料アダプターと機関向けアダプターは、フィクスチャベースの契約テストでカバーされています。実際の利用権限のテストには、アクセス権のあるアカウントが必要です。

明示的な公開 API スモークテストも別途利用できます。

uv run python scripts/smoke_public.py

アカウントの認証情報は無視し、Crossref、DataCite、Europe PMC、arXiv、および匿名の Semantic Scholar にのみ接続します。レート制限やネットワーク障害は結果として報告されます。

公式 MCP Tasks 拡張機能は案内していません。SDK 2.2 はまだこれを実装していません。batch-citations は、進捗状況の通知とキャンセル機能を備えた、範囲が限定された同期ワークフローであり、永続的なジョブキューではありません。ロードマップでは、永続タスク、ローカルライブラリ、および追加のライセンス済みプロバイダーを導入するための基準を説明しています。

ローンチキットには、ポジショニング、掲載文、デモ用スクリプト、プロモーション文案が含まれています。マーケットプレイス一覧では、確認済みの掲載先、重複する掲載先、活動停止中または未解決のサイトを含む 41 のチャネルと見込み先を管理しています。ソースのメタデータ、ポータブルなプラグインマニフェスト、画像アセットはレビュー用に準備されています。オプションのプロバイダーを設定したりホスティングしたりする前に、データの取り扱いをご覧ください。

ライセンス

MIT。プロバイダーのコンテンツ、API アクセス、および再配布には、それぞれのソースの利用規約が適用されます。