Usgs Critical Deposits

@pipeworx/usgs-critical-deposits

USGS の「米国の重要鉱物鉱床」（第 3.0 版、2026 年 9 月）です。41 州とプエルトリコにわたる、記録済み鉱床 1,271 件を収録しています。各鉱床は鉱物システムと鉱床タイプに分類され、生産履歴、資源量・埋蔵量の数値、参考文献が含まれます。MRDS、ARDF、USMIN に加え、業界レポートや文献をもとにまとめられています。これは、MRDS の未加工の鉱床産出情報を扱い、重要鉱物の資源量や参考文献を整理・編集した資料を含まない usgs-mrdata や、鉱床ごとの記録ではなく全国の生産・貿易の概要を扱う usgs-mineral-commodities とは異なります。

Pipeworx の一部です。AI エージェントを 1764 件以上のライブデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の連携であり、元の提供元とは提携しておらず、承認や公開も受けていません。

ツール

• usgs_cmd_deposits_search(commodity?, state?, bbox?, limit?) — 重要鉱物・商品（例：「lithium」「cobalt」「ree」）、米国の州または準州の略称、またはバウンディングボックスで検索します。各鉱床の ID、名称、州、座標、鉱物、鉱床タイプ、資源量の数値を返します。認識されない商品名の場合は、found: false と、このデータセットに実際に鉱床が登録されている商品名の全リストを返します（下記の「商品名の一覧」を参照）。
• usgs_cmd_deposit_detail(id) — 1 件の鉱床の完全な記録を返します。鉱物、鉱床タイプ、鉱物システム、生産履歴、資源量・埋蔵量の数値、参考文献、基になる MRDS／ARDF／USMIN レコードへのリンク、リリースのバージョンと DOI が含まれます。

認証

キー不要です。

データソース

• https://energy.usgs.gov/arcgis/rest/services/Hosted/Critical_mineral_deposits_of_the_United_States/FeatureServer/0/query — このパックがリクエストごとにプロキシする、稼働中の ArcGIS FeatureServer です。
• https://doi.org/10.5066/P9K1HBNT — データリリース本体です（ScienceBase のアイテム 6464de5bd34ec179a83d9e6c）。「米国の重要鉱物鉱床（第 3.0 版、2026 年 9 月）」です。FGDC メタデータの改訂日は 2026-09-09 です。USGS による更新の公開発表日は 2026-09-29 です。

テーブルを組み込まず、ライブデータをプロキシする理由

このリリースにはダウンロード専用の Excel／シェープファイル一式も含まれていますが、USGS は同じテーブルを、キー不要の ArcGIS FeatureServer としても公開しています（2026-10-08 に稼働を確認）。そのため、実際にファイルのみを提供する usgs-mineral-commodities とは異なり、これはミラーではなく、リクエストごとにライブデータを呼び出すプロキシです。ルートの CLAUDE.md にある「PROXYING is not REDISTRIBUTING」に基づき、再利用許可は不要です。KV へのデータ格納も、モジュールスコープのデータテーブルもありません。

上流は実測で不安定です

2026-10-08 のライブ測定では、まったく同じ未変更のクエリ（where=1=1&outFields=fid&resultRecordCount=3）が、約 45 秒間にわたって 6 回連続で HTTP 502 を返した後、こちら側では何も変更していない状態で、次の試行で HTTP 200 を返しました。これは不正なリクエストではなく、上流の ArcGIS ホスティングインフラの一時的な不具合です。このパックのすべての呼び出しは、2xx 以外のステータス、JSON 以外の本文、または ArcGIS 形式の {"error": {...}} レスポンスに対して、上流のステータスを明示してエラーをスローします。実際の検索結果が 0 件の場合と区別できなくなるため、found: false や空の鉱床リストに変換することはありません。固定された契約については src/index.test.ts を参照してください。

商品用語

基になるデータセットの CritMin フィールドは自由記述で、カンマ区切りです。個々の元素に加えて、USGS 独自のグループ略称（「ree」「pge」）や、複数語からなる生の値（「palladium rhenium」「tantalum tin」）がいくつか混在しています。商品ごとに1つのトークンが入る整ったフィールドではなく、USGS が発表した「59の重要鉱物」の数とも一致しません（2025年重要鉱物リストの60品目から、このデータセットでは扱わない冶金用石炭を除いた数です）。数が異なるのは、このリリースでは60品目のうちいくつかについて確認済みの鉱床がゼロであること、また、グループ化されたトークン（ree、pge）が公式リストで個別に名付けられた複数の元素を表しているためです。

そのため、このパックでは commodity の検証に、プレスリリースのリストを再入力したものではなく、データセット自体からその場で導出した語彙を使用します。これは、1,271件の鉱床全体に実際に含まれる、カンマで分割して小文字に変換したすべての異なるトークンです（2026-10-08時点で47トークン）。これにより、deposits_search が、検索しても一致しない商品を「見つかりません」と返すことがなくなります。語彙は isolate ごとに一度取得され、メモ化されます。取得に失敗した場合はメモがクリアされるため、isolate の稼働期間全体にわたって空の語彙が固定されるのではなく、次の呼び出しで再試行されます。

既知のフィールドの特性

• state は米国の州／準州を表す2文字の略称です。プエルトリコは PR です。 国によるフィルターはありません。このデータセットは米国のみ（PRを含む）を対象としています。
• resources1～resources4、prduction1～prduction3、comments1～comments3 は、USGS 独自のテキスト超過用継続列です（254文字を超えた自由記述セル1つが、次の番号付きフィールドに引き継がれます）。このパックでは、番号付きの生フィールドを公開するのではなく、空でない値を resources／production_history／comments 配列に連結します。
• references_（生のフィールド名の末尾にアンダースコアがあります。references は一部の ArcGIS クライアントライブラリで予約語に近いためです）は、このパックの出力では references として公開されます。
• ソース内の空セルは、空文字列や null ではなく、単一の空白文字 " " または文字列リテラル "--" として返されます。resources／production_history／comments 配列を作成する前に、どちらも除外されます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "usgs-critical-deposits": {
      "url": "https://gateway.pipeworx.io/usgs-critical-deposits/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/usgs-critical-deposits/mcp の tools/list は、上の表にあるツールに加えて、共通の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール一式）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとあわせて、共通ツールがおよそ30個表示されます。接続の initialize 応答には正確な範囲が記載されており、その日の時点での正式な情報となります。

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使うと、このパックの対象外の質問にも、カタログ全体を横断する ask_pipeworx 経由で回答できます。そのため、2つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマがもたらすコンテキスト負荷がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、Pipeworx フルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと、同じ1,764以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらから接続しても、ask_pipeworx ですべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/usgs_cmd_deposits_search \
  -H 'Content-Type: application/json' \
  -d '{"commodity":"lithium","state":"AR"}'

最初の呼び出しにアカウントは必要ありません。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/usgs_cmd_deposits_search を呼び出します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "usgs-critical-deposits": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-usgs-critical-deposits"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-usgs-critical-deposits

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Usgs Critical Deposits data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT