Nasa Ads MCP

🚀 NASA ADS MCP 服務器

本服務器基於模型上下文協議（MCP）構建，可讓你在 Claude 中無縫訪問美國國家航空航天局天體物理學數據系統（NASA ADS）。你可以通過自然語言對話，輕鬆搜索論文、跟蹤引用、管理文獻庫並導出參考文獻。

🚀 快速開始

本 MCP 服務器是與 Claude（Anthropic 開發）合作的實驗成果，旨在優化文獻搜索工作流程。它藉助了 Anthropic 提供的 mcp-builder 技能，所有代碼均由 Claude 根據要求、領域知識和人工反饋生成。目前服務器運行良好，但尚未經過廣泛測試。歡迎你進行復刻、貢獻代碼或提出改進建議。

✨ 主要特性

此 MCP 服務器提供了 10 種與 NASA ADS 交互的工具：

搜索與發現

• 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：

• ✅ 搜索 API：支持完整查詢功能和特定字段搜索。
• ✅ 指標 API：提供作者和論文級別的指標。
• ✅ 文獻庫 API：支持文獻庫的完整 CRUD 操作。
• ✅ 導出 API：生成 BibTeX 引用。
• ⏳ 期刊 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 調用（指標和文獻庫）。
• 使用 python-dotenv 安全管理令牌。

服務器使用方式

• 使用 stdio 傳輸 與 Claude Desktop 進行通信。
• 對指標和文獻庫使用 直接 API 調用（ads 包未完全支持）。
• 速率限制 由 NASA ADS API 處理（通過響應頭監控）。

🔍 已知限制

• 速率限制：NASA ADS 實施了速率限制，請監控大查詢的使用情況。
• 閱讀量指標：目前返回 0（API 限制，非服務器問題）。
• BibTeX 格式：基本實現，不包含所有可能的字段。

🛠️ 故障排除

服務器無法啟動

1. 驗證是否安裝了 Python 3.10 及以上版本：python3 --version。
2. 檢查 .env 文件中是否包含 API 令牌。
3. 確保 uv sync 成功完成。
4. 在設置 > 開發者中檢查 Claude Desktop 日誌。

API 錯誤

1. 驗證你的 ADS API 令牌是否有效。
2. 檢查是否達到速率限制。
3. 確認 bibcode 格式正確。

在 Claude 中看不到工具

1. 完全退出並重啟 Claude Desktop。
2. 檢查輸入框中是否出現 🔨 錘子圖標。
3. 驗證配置路徑是否為絕對路徑，而非相對路徑。

🙏 致謝

• NASA 天體物理學數據系統：提供 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 上創建 issue 或通過倉庫聯繫我們。

想了解更多關於 MCP 的信息？ 請訪問 modelcontextprotocol.io