ADS文献管理服务器

一个强大的MCP服务器,用于NASA天体物理学数据系统(ADS),支持通过自然语言搜索论文、遍历引文图、导出BibTeX、计算指标和管理阅读列表。

  • by cbyrohl
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 cbyrohl/mcp-server-ads

使用说明

mcp服务器广告

一个强大的 主控程序 服务器 美国国家航空航天局天体物理数据系统(ADS) --天体物理学文献的主要数据库。通过自然语言搜索论文、前后遍历引文图、导出BibTeX、计算指标和管理阅读列表。适用于Claude Desktop/Code、Cursor、OpenAI Codex和任何兼容MCP的客户端。

demo_15fps_crf20.webm

快速开始

获取ADS API代币

  1. 在以下网址创建免费帐户 美国国家航空航天局广告
  2. 登录并转到 设置>API令牌
  3. 点击 生成新密钥 并复制令牌

安装

不需要单独的安装步骤——下面的客户端配置使用 uvx 自动获取并运行服务器。只需选择你的客户并离开。需要Python 3.11+和 紫外线.

克劳德代码

claude mcp add --scope user mcp-server-ads -e ADS_API_TOKEN=your-api-token-here -- uvx --from git+https://github.com/cbyrohl/mcp-server-ads mcp-server-ads

使用 --scope project 而是通过以下方式共享配置 .mcp.json 在您的仓库中,或省略 --scope 适用于本地(仅限当前项目)。

克劳德桌面版

添加到您的 Claude桌面配置:

{
  "mcpServers": {
    "ads": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/cbyrohl/mcp-server-ads", "mcp-server-ads"],
      "env": {
        "ADS_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Codex 命令行界面

codex mcp add mcp-server-ads --env ADS_API_TOKEN=your-api-token-here -- uvx --from git+https://github.com/cbyrohl/mcp-server-ads mcp-server-ads

这将安装到 ~/.codex/config.toml (用户级别,适用于所有项目)。对于项目范围的配置,将条目添加到 .codex/config.toml 在你的项目根目录中。

独立/Python API

如果你想直接安装这个包(例如作为Python库或手动运行服务器):

# Install with uv
uv tool install git+https://github.com/cbyrohl/mcp-server-ads

# Or with pip
pip install git+https://github.com/cbyrohl/mcp-server-ads

从源头运行

git clone https://github.com/cbyrohl/mcp-server-ads.git
cd mcp-server-ads
uv sync

# Run the server
ADS_API_TOKEN=your-token uv run mcp-server-ads

配置

环境变量 必填 默认 描述
ADS_API_TOKEN 是 - ADS中的API令牌
ADS_API_URL 没有 https://api.adsabs.harvard.edu API基本URL(替代SciX)

工具(11)

搜索

工具 说明
ads_search 使用完整的查询语法搜索ADS数据库,包括 citations(), references(), similar(), trending(),以及 reviews() 操作员
ads_bigquery 在一组特定的bibcode中搜索(最多2000个)

出口和指标

工具 说明
ads_export 导出18+种格式的记录(BibTeX、AASTeX、RIS、CSL等)
ads_metrics 计算引用指标(h指数、g指数、引用计数等)

图书馆

工具 说明
ads_library 管理库:列出、获取、创建、编辑或删除已保存的论文集
ads_library_documents 管理库中的文档和笔记:添加/删除纸张,设置操作(并集、交集、差分、复制、清空)和笔记CRUD

发现与解决

工具 说明
ads_resolve_links 解析论文的可用链接(全文、数据等)
ads_object_search 将天体名称转换为ADS查询(SIMBAD/NED)
ads_citation_helper 建议应与给定论文集一起引用的论文
ads_resolve_reference 将自由文本引用字符串解析为ADS bibcodes

网络可视化

工具 说明
ads_network 从一组论文中生成作者协作或论文引用网络

资源

URI 描述
ads://fields 可搜索和可返回ADS字段的完整参考
ads://syntax ADS查询语法快速参考示例
ads://rate-limits 实时API费率限制状态

提示

提示 描述
literature_review 研究主题的多步文献综述工作流程
citation_analysis 一组论文的引文网络分析工作流程
generate_bibliography 从搜索或bibcodes生成格式化的参考书目

类似项目

该服务器专注于广泛的ADS API覆盖范围、令牌高效输出和集成测试的可靠性。与基于arXiv的工具相比,ADS支持前向/后向引用遍历(任何论文的引用和参考文献),尽管它侧重于天体物理学。

发展

# Install dev dependencies
uv sync

# Run tests
uv run pytest

# Lint
uv run ruff check src/ tests/

# Run the server locally
ADS_API_TOKEN=your-token uv run mcp-server-ads

许可证

麻省理工学院