datacite-mcp-server

---

概要

世界中のリポジトリが登録した、データセット、ソフトウェア、サンプル、ワークフロー、その他の研究成果の DataCite DOI メタデータを扱います。検索、レコードの詳細表示、DOI の関連（バージョン、構成要素、補足資料、引用）の追跡、分野ごとに公開しているリポジトリの検索、引用の整形ができます。API キーは不要です。

ツール

ツール	説明
datacite_search_works	プレーンテキストまたはクエリ構文と構造化フィルターで研究成果を検索します。関連度順のページ表示またはカーソルによる全件取得に対応し、ファセット件数も任意で取得できます
datacite_get_work	1 つの DOI の登録メタデータ全体を取得するか、DataCite が扱っていない DOI をどの登録機関が管理しているかを確認します
datacite_trace_relations	任意の DOI を中心とする関連グラフ（バージョン、構成要素、補足資料、派生物、引用）を、各エッジの情報源とともに示します
datacite_search_repositories	テキスト、科学分野、種類、認証、ソフトウェア、プロバイダーでリポジトリアカウントを検索し、研究成果の検索フィルターで使う repositoryId を取得します
datacite_get_citation	DOI を CSL スタイルとロケールに応じた書式の引用、または BibTeX、RIS、CSL JSON などの機械可読形式に変換します
datacite_list_reference	他のツールが受け付ける語彙、識別子の形式、網羅範囲のルールをオフラインで確認します

機能リファレンス

datacite_search_works _ツール

• text（山括弧を除いたリテラル語。空白以外のテキストに検索可能な句が残らない場合は invalid_text エラー）または query（OpenSearch クエリ構文）を、次のフィルターと AND 条件で適用します：resource_types、creator（ORCID iD または名前）、affiliation（ROR ID または名前）、affiliation_country、funder（ROR ID、Crossref Funder ID、または名前。ROR の資金提供者を指定する場合は include_child_funders も指定可能）、subject、fields_of_science、repository_ids、provider_ids、licenses、language、place、published_from / published_to、min_citations。リスト型フィルターでは最大 10 個の値を指定でき、いずれかが一致すれば対象になります
• limit は 1～10,000（デフォルトは 20）です。最大 100 件まで適用され、その場合は通知が返されます。sort（relevance、newest、oldest、recently_updated、most_cited、most_viewed、most_downloaded）に従って順位付けされた pages では、最初の 10,000 件まで取得できます（text または query がある場合のデフォルトは relevance、それ以外は newest）。一方、cursor: "*" は nextCursor を使って登録順に結果セット全体をたどり、page も sort も使用しません。順位付け検索の上限に達した場合は、最終ページとは区別して通知されます
• Crossref Funder ID は検索前に、完全一致する単一の ROR FundRef マッピングを通じて funded-by に解決されます。マッピングを利用できない、不完全、または曖昧な場合は、識別子とのリテラル一致を維持し、検索範囲が縮小することを明示します。キャッシュされ、間隔を空けて実行される照会は最大 5 秒で、再試行は行われません。カーソルでの検索では、サーバーの再起動をまたぐ場合も含め、初回に解決または指定されたリテラルのフィルターをすべての継続検索で維持し、ROR への再照会は行いません。include_child_funders を使うには、ROR を明示的に指定する必要があります
• ライセンス ID は前後の空白を除去して小文字に変換しますが、内部の空白は保持します（cc0 1.0 と cc0-1.0 は異なります）。ライセンスのファセット ID をそのまま再利用してください。query は寄託のタイムスタンプにも対応します。例：created:[2026-10-16 TO *]、updated、registered
• include_facets を指定すると、リソースタイプ、年、リポジトリ、プロバイダー、所属機関、科学分野、ライセンスの上位件数が追加されます（処理時間が 2～8 秒長くなります）。すべてのレスポンスには totalCount、effectiveQuery、sortApplied、appliedFilters が含まれます

---

datacite_get_work _ツール

• doi を 1 つ指定します。大文字・小文字は問いません。プレフィックスなし、doi: または info:doi/ 付き、doi.org URL、あるいは %2F エンコード形式が使えます
• タイトル、ORCID iD と ROR の所属機関を含む作成者と寄稿者、日付、主題、説明、資金提供、地理的位置情報、権利、関連識別子と関連アイテム、リポジトリとプロバイダー、および counts（引用、参考文献、バージョン、パーツ、閲覧、ダウンロード）を返します。長いリストには上限があり、全件数は truncatedLists と relatedIdentifierCounts で報告されます
• 0 始まりの offset（デフォルトは 0）を指定して、上限付きリストの 1 ページ目を取得できます。creators、contributors、relatedIdentifiers、subjects、fundingReferences は最大 100 件、relatedItems は 25 件、geoLocations は 50 件を返します。オフセットは、寄託順に並んだ有効なマッピング済みエントリーを基準にします。エントリーが残っている場合、listPage は list、offset、total、nextOffset を報告します。それ以外のメタデータには通常の上限が適用されます。デフォルトの切り詰め通知には、続きの取得に必要な入力値が正確に記載されます。オフセットを指定するにはリストが必要です。末尾を超えたページは空になります
• タイトルと検索スニペットはプレーンテキストです。認識された書式タグを除去し、エンティティを 1 回デコードしてから、スニペットを切り詰めます。構造化された説明は寄託されたテキストを保持し、レンダリングされた説明は段落と行の区切りを保持します
• 地理的位置情報では、点、矩形、順序を保ったポリゴン頂点、および任意のポリゴン内点を保持します。不完全なポリゴンは通知とともに省略されます。有効な同階層のジオメトリは保持されます
• DataCite に DOI の公開レコードがない場合は、found: false とともに missReason（other_agency、does_not_exist、not_public、unclassified）、判明している場合は registrationAgency、および guidance を返します

---

datacite_trace_relations _ツール

• 任意の機関のdoi：DataCite のデータセットまたはソフトウェアの DOI、あるいはジャーナル論文の DOI を指定すると、引用している、引用されている、補足している、または派生元となっている DataCite のデータおよびソフトウェアを検索します
• depth は 1（デフォルト）または 2 です。2 ホップ目では、DataCite の隣接ノードを最大 10 件展開します。1 ホップ目で max_nodes に空きがある場合にのみ実行されます。max_nodes は 1～10,000（デフォルト 50、ルートを含む）です。上限は最大 100 として適用され、通知が表示されます。ノードは、対象自身のメタデータ、次にルートを指すレコード、次に Event Data のエンドポイント、最後に 2 ホップ目の順で追加されます。relation_types を指定すると、列挙した関係タイプのみが残り、追跡対象の DOI 側から読み取られます（省略時はすべて）。include_event_data（デフォルトは true）を指定すると、Event Data の引用リンクが追加されます
• エッジには、主張されたとおりの relationType が保持され、その sources（metadata、reverse_metadata、event_data）が列挙されます。coverage には各ソースをどこまで読み取ったかが示されます（ホップごとに逆引きレコードを最大 100 件、大量にある場合は先頭 10 件のみ、1 回の呼び出しにつきイベントを最大 100 件）。rootCounts には比較用の DataCite 独自の件数が含まれます。エッジが存在しないことは、関係が存在しない証拠にはなりません
• 逆引きでは、relatedIdentifiers と特定済みの relatedItems の両方を調べ、各主張の対象とタイプを検証したうえで、同一のエッジを統合します
• event_offset（0～9,999、絶対値でゼロ始まり）を指定すると、0 を指定した場合も含め、Event Data のみを追跡します。メタデータのエッジと深さ 2 の展開はスキップされます。coverage.eventData.nextEventOffset と同じ DOI およびフィルターを使って続行してください。各呼び出しでは上流の 1 ページを読み取り、対象エンドポイントを max_nodes に収められない場合は、その直前で停止します。ルートのみの呼び出しでは、上限を引き上げる方法が説明されます。カバレッジでは、読み取りの完了、分類情報の照会が妨げられた場合、読み取りが利用できない場合またはスキップされた場合、上流の 10,000 件という上限がそれぞれ区別されます。呼び出し間で上流の並び順が変わることがあります。続きの取得はスナップショットではありません

---

datacite_search_repositories _ツール

• 名前と説明を対象とするテキスト query に加え、field_of_science、repository_types、certificates、software、client_type、provider_id を指定できます。または、repository_ids のみを指定し（入力は最大 1,000 件）、入力順で正規化された ID のうち最初の 25 件（重複を除く）を検索できます。検索されなかった ID は通知に表示されます。見つからない ID の通知対象は、検索された ID のみです
• limit は 1～10,000（デフォルト 20）で、page と併用できます。上限は最大 100 として適用され、通知が表示されます。名前順の行には、datacite_search_works の repository_ids で指定する repositoryId に加え、providerId、タイプ、認証、ソフトウェア、分野、ホームページ、re3data リンクが含まれます
• 検索レスポンスには、検索条件を組み合わせた effectiveQuery がエコーされます（クエリ条件がない場合は *）。結果が空のページでも同様です。ID 検索では、クエリのエコーはなく、appliedFilters.repository_ids が返されます

---

datacite_get_citation _ツール

• format：text（デフォルト）、csl_json、bibtex、ris、datacite_json、datacite_xml、schema_org、codemeta、または jats
• text のみ：style には CSL スタイル ID を指定します（デフォルトは apa。確認済みの ID は datacite_list_reference の citation_styles トピックを参照）。DataCite が APA として暗黙に出力するスタイルを指定すると、unsupported_style エラーになります。locale には、DataCite が出力できる 61 種類の CSL ロケール（en-GB、de-DE、fr-FR、…）か、主要な方言に展開される言語コード単体（de → de-DE）を指定します。デフォルトは en-US です（一覧：citation_locales トピック）
• text では、引用文がプレーンテキストとして citation に、上流のマークアップが citationHtml に返されます。UTF-16 コード単位で 100,000 を超えるテキストペイロードは、サロゲートペアを分割せずに切り詰められます。機械可読形式では、完全なペイロードがこの上限まではインラインで返されます。それを超える文書では citation は省略され、文書全体を取得する downloadUrl と totalCharacters が返されます。この場合、truncated: true、shown: 0、cap: 100000 となります。DataCite に存在しない DOI は、datacite_get_work と同様に found: false を返します。DataCite がその DOI の形式を出力できない場合は、format_unavailable エラーになります

---

datacite_list_reference _ツール

• topic: resource_types、relation_types、identifier_types、date_types、contributor_types、fields_of_science、licenses、repository_types、certificates、software_platforms、client_types、sort_orders、query_syntax、citation_formats、citation_styles、citation_locales、identifier_formats、または coverage
• entries（value、label、group、inverse）と使用上のnotesを返します。上流へのリクエストは行いません

特長

@cyanheads/mcp-ts-coreを基盤としており、stdio および Streamable HTTP トランスポート、切り替え可能な認証（none／jwt／oauth）、交換可能なストレージ（in-memory、filesystem、Supabase、Cloudflare KV/R2/D1）、オプションの OpenTelemetry トレース機能を備えた構造化ログに対応しています。

公開されているdatacite-guideスキルでは、帰属表示、識別子の解決、関係性を示す根拠、網羅的な一覧について解説しています。パッケージとプラグインに同梱されており、MCP Skills 拡張機能から利用できます。

DataCite 固有の機能：

• API キー不要で読み取り専用です。DataCite REST API（/dois、/repositories、/eventsのEvent Data、引用情報向けのDOI コンテンツネゴシエーション）に加え、DataCite が保有していない DOI を対象とする doi.org の登録機関検索を利用します
• リクエスト予算を共有します。ペース制御された単一のリクエストキュー、プロセス内レスポンスキャッシュ、ツール呼び出しごとの 45 秒の期限を備えています。予算を使い切ると、待機時間（秒数）を示す rate_limited として失敗します。DATACITE_CONTACT_EMAILを設定すると、DataCite の識別済みティアが適用され、IP あたり 5 分間の上限が 500 件から 1,000 件に増えます
• 柔軟な識別子に対応します。DOI は大文字・小文字を問わず、プレフィックス付き、または doi.org の URL 形式で指定できます。ORCID iD はチェックサムを検証します。ROR ID と Crossref Funder ID は、単体または URL 形式で指定できます。語彙値は大文字・小文字を問わず、ハイフン、アンダースコア、スペースを使用できます
• DataCite DOI メタデータはCC0 1.0の下で権利放棄されています。この権利放棄の対象は登録されたメタデータのみで、それが説明するデータセット、ソフトウェア、論文は対象外です。datacite_get_workは、metadataLicenseを対象のrightsとは別に報告します

エージェントに適した出力：

• すべての検索に来歴情報を付与します。effectiveQuery、上流に送信したappliedFilters、適用した並べ替えまたは順序、totalCountを含みます。トレースの各エッジにはsourceが示され、coverageには各ソースをどこまで読み取ったかが示されます
• エラーではなく、型付きの不一致を返します。DataCite が保有していない DOI は、found: falseとmissReason、判明している場合は保有機関、次の手順を伴って返されます
• 制限を明示します。上限のある一覧では全件数を報告し、該当なし、10,000 件のページング上限、展開されていない第 2 ホップ、返されたエッジでは網羅されていない引用情報について通知します
• テキスト出力では、登録者が提供したテキスト（タイトル、説明、名前）を引用ブロックに入れるかフラット化し、機械可読ペイロードをコードフェンスで囲むため、登録されたコンテンツが構造として誤認されることはありません。タイトルとスニペットは両方の出力形式で正規化されます。構造化された説明など、登録されたその他のフィールドは元のテキストを保持します

はじめに

インストール不要のホスト型インスタンスに接続します：

claude mcp add --transport http datacite-mcp-server https://datacite.caseyjhand.com/mcp

ホスト型インスタンスのすべての呼び出し元で、DataCite のリクエスト予算（5 分間に 800 件）を共有します。継続的に利用する場合は、独自のインスタンスを実行してください。

またはローカルで実行します：

claude mcp add datacite-mcp-server -- npx -y @cyanheads/datacite-mcp-server

その他のクライアントでは、これを MCP 設定ファイルに追加してください：

{
  "mcpServers": {
    "datacite-mcp-server": {
      "command": "npx",
      "args": ["-y", "@cyanheads/datacite-mcp-server"]
    }
  }
}

API キーは不要です。オプションのDATACITE_CONTACT_EMAILを設定すると、DataCite の IP あたりのリクエスト上限が 2 倍になります。Docker またはソースからのビルドについては、サーバーの実行を参照してください。

設定

変数	説明	デフォルト
DATACITE_CONTACT_EMAIL	User-Agent に mailto: として設定する連絡先メールアドレスです。URL には含めません。DataCite の識別済みティアが適用され、IP あたりのリクエスト数が 5 分間に 500 件から 1,000 件に増えます。起動時にメールアドレスとして検証されます。	なし
DATACITE_MAX_REQUESTS_PER_5MIN	5 分間のリクエスト上限です。50～1000 の整数を指定します。同じ送信元 IP を共有するレプリカ間で分割してください。	連絡先メールアドレスがある場合は 800、ない場合は 400
MCP_TRANSPORT_TYPE	トランスポート：stdio または http。	stdio
MCP_HTTP_PORT	HTTP サーバーのポート。	3010
MCP_SESSION_MODE	HTTP セッションモード：stateless、stateful、または auto。	stateless
MCP_AUTH_MODE	認証：none、jwt、または oauth。	none
MCP_LOG_LEVEL	ログレベル（debug、info、warning、error など）。	info
LOGS_DIR	ログファイルのディレクトリ（Node.js のみ）。	<app-root>/logs
STORAGE_PROVIDER_TYPE	ストレージバックエンド：in-memory、filesystem、supabase、cloudflare-kv/r2/d1。	in-memory
OTEL_ENABLED	OpenTelemetry を有効にします。	false

オプションの上書き設定の全リストは .env.example を参照してください。

サーバーの実行

Bun v1.4.0 以上、または Node.js v24+ が必要です。ソースからビルドするには：

git clone https://github.com/cyanheads/datacite-mcp-server.git
cd datacite-mcp-server
bun install
cp .env.example .env

DataCite の識別済みティアを利用するには、.env で DATACITE_CONTACT_EMAIL を設定してください。

ローカル開発

• 本番版をビルドして実行する：

  # One-time build
  bun run rebuild
  
  # Run the built server
  bun run start:http
  # or
  bun run start:stdio
  

• チェックとテストを実行する：

  bun run devcheck  # Lints, formats, type-checks, and more
  bun run test      # Runs the test suite
  

Docker

stdio 経由で実行する：

docker run -i --rm -e MCP_TRANSPORT_TYPE=stdio ghcr.io/cyanheads/datacite-mcp-server:latest

または、http://localhost:3010/mcp で Streamable HTTP を公開する：

docker run --rm -p 127.0.0.1:3010:3010 ghcr.io/cyanheads/datacite-mcp-server:latest

プロジェクト構成

ディレクトリ	目的
src/index.ts	createApp() のエントリーポイントです。6 つのツールを登録し、サーバーの指示を設定します。
skills/	DataCite ツールを使用するエージェント向けに公開されているガイダンスです。
src/mcp-server/tools	ツール定義（*.tool.ts）と、共通で使用する入力スキーマ、誤りに関するガイダンス、テキスト描画のヘルパーです。
src/services/datacite	DataCite REST クライアント（/dois、/repositories、/events、コンテンツネゴシエーション）、クエリビルダー、識別子の正規化処理、レコードマッパー、関係グラフビルダー、引用スタイルチェックです。
src/services/doi-ra	DataCite が公開レコードを保持していない DOI を対象とする、doi.org の登録機関検索です。
src/services/ror	Crossref Funder ID から ROR への完全一致検索と、リテラル検索によるフォールバックです。
src/services/http	共通の上流パイプラインです。レスポンスキャッシュ、リクエストペーサー、リトライ、呼び出しごとの期限、レート制限処理を提供します。
src/services/reference	datacite_list_reference の静的語彙と入力バリデーターです。
src/config	Zod による、サーバー固有の環境変数の解析と検証です。
tests/	src/ に対応する Vitest テストと、記録済みの DataCite および doi.org のフィクスチャです。

開発ガイド

開発ガイドラインとアーキテクチャ上のルールについては、CLAUDE.md を参照してください。要点は次のとおりです。

• ハンドラーは例外をスローし、フレームワークが捕捉します。ツールのロジックに try/catch を書かないでください。
• ログには ctx.log を、ストレージには ctx.state を使用してください。
• 新しいツールは src/index.ts の createApp() 配列に登録してください。
• 外部 API 呼び出しは、未加工データを検証し、ドメイン型に正規化してから、出力スキーマを返すようにしてください。不足しているフィールドを捏造しないでください。

コントリビューション

Issue を歓迎します。提出前にチェックとテストを実行してください。

bun run devcheck
bun run test

ライセンス

このプロジェクトは Apache 2.0 License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。