Nasa Ads MCP

🚀 NASA ADS MCP Server

このModel Context Protocol (MCP) サーバーは、Claude内から直接NASA天体物理学データシステム (ADS) にシームレスにアクセスできるようにします。自然言語での会話を通じて、論文の検索、引用の追跡、ライブラリの管理、参考文献のエクスポートなどを行うことができます。

🚀 クイックスタート

このMCPサーバーを使用することで、Claude内から直接NASA ADSにアクセスできるようになります。以下の手順に従ってセットアップを行ってください。

✨ 主な機能

このMCPサーバーは、NASA ADSとやり取りするための10のツールを提供します。

検索と発見

• search_papers - 自然言語クエリでADSデータベースを検索します。
• get_paper_details - 特定の論文の包括的なメタデータを取得します。
• get_author_papers - 特定の著者のすべての出版物を検索します。

メトリクスと分析

• get_paper_metrics - 特定の論文の引用数、閲覧数、影響力を追跡します。
• get_author_metrics - h指数、引用統計、研究の影響力を計算します。

参考文献管理

• export_bibtex - 適切にフォーマットされたBibTeX引用をエクスポートします。
• list_libraries - 個人のADS論文コレクションを表示します。
• get_library_papers - 特定のライブラリから論文にアクセスします。
• create_library - トピックまたはプロジェクトごとに論文を整理します。
• add_to_library - 論文コレクションを構築および維持します。

📦 インストール

前提条件

• Claude Desktop がインストールされていること (ここからダウンロード)
• Python 3.10以上
• uv パッケージマネージャー (ここでインストール)
• NASA ADS APIトークン (ここで取得)

セットアップ

1. このリポジトリをクローンします:

git clone https://github.com/prtc/nasa-ads-mcp.git
cd nasa-ads-mcp

2. 依存関係をインストールします:

uv sync

3. APIトークンを設定します:

プロジェクトのルートに .env ファイルを作成します:

cp .env.example .env

.env を編集し、NASA ADS APIトークンを追加します:

ADS_API_TOKEN=your_token_here

4. Claude Desktopの設定に追加します:

Claude Desktopの設定ファイルを編集します:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

mcpServers セクションに以下のエントリを追加します:

{
  "mcpServers": {
    "nasa-ads": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/nasa-ads-mcp",
        "run",
        "python",
        "src/nasa_ads_mcp/server.py"
      ]
    }
  }
}

/absolute/path/to/nasa-ads-mcp を実際にクローンしたリポジトリのパスに置き換えてください。

5. Claude Desktopを再起動します

入力ボックスに🔨ハンマーアイコンが表示されることを確認して、サーバーが接続されていることを確認します。

💻 使用例

接続が完了したら、Claude内で自然言語を使用してADSとやり取りできます。

基本的な使用法

検索と発見

"Search for recent papers on stellar populations in elliptical galaxies"
"Find papers by Coelho, Paula R. T. from 2020-2025"
"What are the most cited papers on galaxy formation?"

メトリクスと影響力

"What's my current h-index and total citations?"
"Show me citation trends for bibcode 2005A&A...443..735C"
"Get metrics for my 2024 papers"

参考文献管理

"Export BibTeX for these 5 papers: [bibcodes]"
"Show me what's in my 'Stellar Spectral Libraries' collection"
"Create a new library called 'Review Paper References'"
"Add these papers to my reading list"

📚 ドキュメント

APIのカバレッジ

このサーバーは以下のAPIを実装しています:

• ✅ Search API - フィールド固有の検索を含む完全なクエリ機能
• ✅ Metrics API - 著者および論文レベルのメトリクス
• ✅ Libraries API - コレクションの完全なCRUD操作
• ✅ Export API - BibTeX引用の生成
• ⏳ Journals API - 将来的な拡張予定

開発

プロジェクト構造

nasa-ads-mcp/
├── src/
│   └── nasa_ads_mcp/
│       ├── __init__.py
│       └── server.py          # 主なMCPサーバーの実装
├── tests/
├── .env.example               # APIトークンのテンプレート
├── .gitignore
├── pyproject.toml            # プロジェクトの設定
├── README.md
└── LICENSE

テスト

簡単な接続テストが含まれています:

uv run python test_connection.py

コントリビューション

コントリビューションは大歓迎です！このプロジェクトは、以下のような改善に特に適しています:

• より多くのADS APIエンドポイントの追加
• エラーハンドリングの改善
• 引用フォーマットの強化
• より多くのメトリクスの可視化の追加

🔧 技術詳細

このサーバーは以下のもので構築されています:

• MCP SDK - Claude Desktopとの統合
• ads Pythonパッケージ - ADS APIへのアクセス
• requests - 直接のAPI呼び出し (Metrics & Libraries)
• python-dotenv - 安全なトークン管理

サーバーは以下を使用しています:

• stdio transport - Claude Desktopとの通信
• Direct API calls - MetricsとLibrariesのための直接のAPI呼び出し (adsパッケージで完全にサポートされていない)
• Rate limiting - NASA ADS APIによって処理される (レスポンスヘッダーを介して監視)

既知の制限事項

• レート制限: NASA ADSはレート制限を適用しています。大規模なクエリの場合は使用状況を監視してください。
• 閲覧数メトリクス: 現在は0を返します (APIの制限であり、サーバーの問題ではありません)
• BibTeXフォーマット: 基本的な実装であり、すべての可能なフィールドを含んでいません。

トラブルシューティング

サーバーが起動しない場合

1. Python 3.10以上がインストールされていることを確認します: python3 --version
2. APIトークンが .env ファイルに含まれていることを確認します。
3. uv sync が正常に完了したことを確認します。
4. 設定 > 開発者 でClaude Desktopのログを確認します。

APIエラーが発生した場合

1. ADS APIトークンが有効であることを確認します。
2. レート制限に達していないことを確認します。
3. Bibコードが正しくフォーマットされていることを確認します。

Claudeでツールが表示されない場合

1. Claude Desktopを完全に終了して再起動します。
2. 入力欄に🔨ハンマーアイコンが表示されることを確認します。
3. 設定パスが絶対パスであり、相対パスではないことを確認します。

謝辞

• NASA Astrophysics Data System - APIを提供してくれたこと
• Anthropic - MCPとClaudeを作成してくれたこと
• 天文学コミュニティ - 世界最高の文献データベースを維持してくれたこと

引用

このツールを研究ワークフローで使用した場合は、以下のように引用できます:

@software{nasa_ads_mcp,
  author = {Paula Coelho},
  title = {NASA ADS MCP Server},
  note = {Code generated by Claude (Anthropic)},
  year = {2025},
  url = {https://github.com/prtc/nasa-ads-mcp}
}

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

質問や問題がありますか？ GitHubでイシューを開くか、リポジトリを通じて連絡してください。

MCPについてもっと学びたいですか？ modelcontextprotocol.io を訪問してください。