Nasa Ads

@pipeworx/nasa-ads

NASA Astrophysics Data System — 1823 年以降の天文学および天体物理学に関するほぼ完全な文献目録で、引用と参考文献のグラフが人手で精選されています。

Pipeworx の一部です。AI エージェントを 1683 以上の稼働中のデータソースにつなぐ MCP ゲートウェイです。

ツール

• ads_search(query, sort?, limit?, start?, include_abstract?) — ADS の完全なクエリ構文を使って文献を検索します（author:"Rubin, V"、year:2020-2024、bibstem:ApJ、abs:"phrase"、property:refereed）。
• ads_paper(identifier) — bibcode、DOI、または arXiv id で指定した論文の完全なレコードを取得します。識別子の形式を検出し、適切なフィールドで検索するため、DOI が無関係な論文にひそかにフリーテキスト一致することはありません。
• ads_citations(bibcode, direction?, sort?, limit?, start?) — この論文を引用している論文（citations、デフォルト）、または参考文献（references）を取得します。

認証

BYO のみです。 _apiKey を渡してください。キーなしで利用する方法はありません。 ADS はすべてのエンドポイントで Bearer 認証を要求し、認証されていないリクエストには例外なく 401 Missing "Authorization" in headers が返されます（2026-09-17 に確認）。拒否時のメッセージには「API キーが必要です」と表示されるため、呼び出し元が 401 をこちらの障害と誤解することはありません。

トークンは無料で、利用枠にも余裕があります。https://ui.adsabs.harvard.edu/ でアカウントを作成し、Settings → API Token（https://ui.adsabs.harvard.edu/user/settings/token）にアクセスしてください。

プラットフォームのフォールバック：PLATFORM_ADS_TOKEN。このシークレットが設定されるまでは、pack-manifest のエントリーに byoExpected: true が含まれます。値を追加する変更と同時にこれを削除してください。

データソース

• https://api.adsabs.harvard.edu/v1/search/query — ここにあるすべてのツールは、異なる q を指定してこのエンドポイントを 1 回呼び出します。ads_citations は別のエンドポイントではなく、ADS 独自の citations(bibcode:...) および references(bibcode:...) 演算子を使用します。

注意点

• 実際には fl は省略できません。 省略すると、ADS はタイトル、著者、年を含まない ID だけを返します。結果セットが切り詰められたように見える、正常な 200 レスポンスです。ここにあるすべての呼び出しでは、フィールドリストを明示的に指定しています。
• 引用符で囲まれていない著者名は、フリーテキストとして検索されます。 author:Rubin は著者検索ではありません。author:"Rubin, V" が正しい形式です。フリーテキスト一致ではエラーにならず、もっともらしいものの誤った論文が返されるため、結果がゼロ件の場合の注記でこの点を明記しています。
• 年の範囲は year:2020-2024 です。 year>2020 は構文エラーです。
• bibcode はドットで埋められた正確に 19 文字のコードです（2015ApJ...808...50A）。折り返しによってパディングが失われたコードをコピーすると、何も一致しません。これは「この論文はインデックスに登録されていない」場合と区別できません。
• 引用数がゼロなのは、たいてい実際の結果です。 ここ数か月に出版された論文で citations の結果が空になるのは普通です。不明な bibcode の場合も同様です。どちらもエラーではなくゼロ件を返すため、注記では両方の原因を挙げています。

クイックスタート

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

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

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

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

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

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

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

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

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/ads_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"abs:\"dark energy\" property:refereed","sort":"citation_count desc","limit":20}'

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

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

このパッケージは、ローカルの標準入出力 MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイ経由のラウンドトリップも不要です。

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

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

npx -y @pipeworx/mcp-nasa-ads

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

ask_pipeworx を使用する

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

ask_pipeworx({ question: "your question about Nasa Ads data" })

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

詳細情報

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

ライセンス

MIT