Esa Gaia

@pipeworx/esa-gaia

ESA Gaia DR3 — ESA アーカイブの TAP サービスを通じて検索できる、18 億個の恒星の位置、年周視差（したがって距離）、固有運動、測光データ、天体物理学的パラメーターです。

Pipeworx の一部です。AI エージェントを 1,879 以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式のインテグレーションであり、上流プロバイダーとは提携、承認、公開のいずれも行っていません。

ツール

• gaia_cone_search(ra, dec, radius_arcmin?, max_magnitude?, min_parallax_mas?, limit?) — 天球上の位置を中心とする半径内のすべての恒星を、近い順に距離 （年周視差から算出）とともに取得します。
• gaia_source_by_id(source_id) — 1 個の恒星の完全な位置天文学・測光データを取得します。
• gaia_adql_query(query, limit?) — アーカイブに対して任意の読み取り専用 ADQL SELECT を実行します。 返される行数は 2,000 件に制限されます。

認証

認証キー不要です。同期 TAP エンドポイントの利用にアカウントは必要ありません。

データソース

• https://gea.esac.esa.int/tap-server/tap/sync — IVOA TAP、ADQL、FORMAT=json。 メインテーブルは gaiadr3.gaia_source です。

次の人が同じことを調べ直さずに済むように

• TAP は拒否したクエリにも HTTP 200 を返し、エラーを含む VOTable の <INFO> 要素を付与します。そのため、単純な呼び出し元は失敗を空の結果として記録してしまいます。したがって、data 配列のない JSON 本文はエラーとして扱い、<INFO> のテキストを表示します。
• 年周視差の単位はミリ秒角で、値が負になることもあります。 年周視差はノイズを含む測定値であり、距離そのものではありません。暗い天体の約 5 分の 1 は負の値を持ちます。1000/parallax で距離（パーセク）を求められるのは、年周視差が正で、かつ精度よく測定されている場合に限られます。そのため、年周視差が負の場合、または信号対雑音比が 5 未満の場合、distance_pc は null となり、その理由を示す distance_note が付与されます。それでも逆数を計算すると、もっともらしく見えるものの意味のない数値が生成されます。
• source_id は 64 ビット整数です。 本文の解析時には JSON.parse によって 2^53 を超える値の精度がすでに失われているため、出力時には ID を文字列として再生成し、入力時にも文字列を受け付けます。
• source_id の値はリリースごとに異なります。 DR2 の ID は DR3 では解決できません。
• 匿名の同期エンドポイントは結果を 2,000 行までに制限し、それを超える TOP は通知なしに切り詰めます。 そのため、サーバー側の制限を当てにせず、ここで明示的に上限を適用しています。
• Gaia のデータは高密度です。 銀河面における 1 度の円錐検索では、数百万個の恒星が見つかります。そのため、radius_arcmin のデフォルト値は 3 で、上限は 60 です。

クイックスタート

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

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

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

https://gateway.pipeworx.io/esa-gaia/mcp の tools/list は、上の表に記載されたツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember/recall など、ゲートウェイ全体で使えるツール一式）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールに加えて、およそ 30 個の共有ツールが一覧表示されます。接続の initialize 応答には正確なスコープが記載されており、その日の状況を確認するための確かな情報源です。

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

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/gaia_cone_search \
  -H 'Content-Type: application/json' \
  -d '{"ra":56.75,"dec":24.1167,"radius_arcmin":3,"max_magnitude":15,"limit":5}'

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

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

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

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

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

npx -y @pipeworx/mcp-esa-gaia

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Esa Gaia data" })

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

詳細

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

ライセンス

MIT