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