Jhtdb

@pipeworx/jhtdb

Johns Hopkins Turbulence Databases（JHTDB）の基準 DNS／LES データセットを対象とした点クエリ（速度、圧力、速度勾配）と、各データセットの空間領域、格子解像度、時間範囲、利用可能な物理場のカタログです。

Pipeworx の一部です。AI エージェントを 1882 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、推奨、公開のいずれもされていません。

ツール

• jhtdb_datasets(...) — JHTDB の全データセットカタログ（強制等方性乱流、チャネル流、MHD 乱流、遷移境界層、大気境界層および風力発電所の LES など）。各データセットの空間領域、格子解像度、時間範囲、利用可能な物理場を確認できます。
• jhtdb_point_query(...) — 名前を指定したデータセット内の最大 10 点と 1 時刻について、補間された速度、圧力、または速度勾配の値を取得します。

認証

呼び出し元から見ると、キーは不要です。このパックは、JHTDB 独自の公開テスト用認証トークン（公開元が小規模なクエリに有効と明記）を内部で使用し、各呼び出しを 10 点までに制限しています。これは公開元が定める小規模クエリの許容量を大きく下回るため、Pipeworx のトラフィックが共有テスト用クォータを圧迫することはありません。BYO キーによる上書きには対応していません。テスト用ではない JHTDB トークンの取得は、公開元への機関向けの申請となるため、より大規模なクエリへの需要が確認されない限り、このパックの対象外です。

データソース

• Johns Hopkins University（Institute for Data Intensive Engineering and Science）、Turbulence Databases（JHTDB）— 標準的な乱流の直接数値シミュレーション（DNS）およびラージ・エディ・シミュレーション（LES）。複数の格子解像度での強制等方性乱流、チャネル流、MHD 乱流、均質な浮力駆動流、遷移境界層、回転成層乱流、安定成層大気境界層、風力発電所の LES が含まれます。公開元独自のウェブサービスを介して、任意の点と時刻をクエリできます。

公開元のクエリインターフェースは SOAP 1.1 であり、REST／JSON ではありません。代替となる JSON の点クエリエンドポイントはありません。SOAP エンベロープは src/index.ts で直接構築・解析します（Workers ランタイムで DOMParser が利用できない場合の、このコードベースにおける SOAP／XML 上流サービスの既存の処理方法に合わせた正規表現ベースの XML 照合です。mcps/sdmx-structure を参照してください）。

データセットカタログ（領域の範囲、格子解像度、時間範囲、利用可能な物理場）は、公開元独自の機械可読なデータセット設定から転記したものです。サービスへのプローブで導き出したものではありません。小規模なレコードが 17 件あるだけなので、KV のベイク済みインデックス経由ではなく、src/index.ts 内の通常の配列として保存しています。

値は各データセット固有のシミュレーション単位で返されます。周期ボックスのデータセット（等方性乱流、チャネル流、MHD 乱流）では無次元の DNS コード単位、大気境界層および風力発電所の LES データセットでは SI 物理単位（メートル、秒、パスカル）です。jhtdb_point_query の応答には、クエリした物理場にどちらが適用されるかが示されます。

データセットコード、空間／時間補間方法の列挙値、各データセットが持つ物理場は、すべて公開元の API の定義に厳密に従っています。補間方法の列挙値に誤りがある場合（たとえば、一見もっともらしい FD4NoInt を実際の None_Fd4 の代わりに指定した場合）、エラーを黙って見過ごすのではなく、公開元独自の検証メッセージとともに明確に失敗します。正しい列挙値は、この方法で確認しました。

クイックスタート

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

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

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

https://gateway.pipeworx.io/jhtdb/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 も、同じゲートウェイと同じ 1882 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/jhtdb_datasets \
  -H 'Content-Type: application/json' \
  -d '{}'

最初の呼び出しにはアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/jhtdb_datasets を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

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

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

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

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

npx -y @pipeworx/mcp-jhtdb

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

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な言葉で質問できます。上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Jhtdb data" })

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

詳細

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

ライセンス

MIT