SciX / NASA ADS

scix-client

scix-client 让 AI 助手可以直接访问 SciX / NASA ADS 数据库。通过自然语言搜索文献、构建参考文献目录、分析引文网络、管理个人文库、通过 SIMBAD/NED 解析天体名称，并以 BibTeX、AASTeX 或其他 15 种格式导出参考文献。

它也可以独立使用：作为 CLI 工具、Python 库或 Rust crate。

研究工作流： 文献综述、参考文献目录管理、引文分析、参考文献导出、天体名称解析、论文详情、文库协作、注释/笔记

一个二进制文件（scix）即可完成所有操作。Python 绑定由 Rust 类型自动生成，无需额外维护。

你需要免费的 SciX / ADS API 令牌，获取地址为 https://ui.adsabs.harvard.edu/user/settings/token。以下每种方式都会提示你输入一次，并为你保存。

Claude Desktop：一键安装

1. 从最新版本下载 scix-vX.Y.Z.mcpb（一个文件同时适用于 macOS 通用版和 Windows）。
2. 双击该文件（或将其拖到 Claude Desktop → Settings → Extensions）。
3. 按提示粘贴你的 API 令牌。完成——无需终端、无需 PATH、无需 JSON。

其他情况：安装 scix，然后运行 scix setup

任选一种安装程序：

# One-line installer (prebuilt binary, no Rust toolchain)
curl -sSf https://raw.githubusercontent.com/yipihey/scix-client/main/install.sh | sh

# Python (also gives you the scix_client module)
pip install scix-client        # or: pipx install scix-client / uv tool install scix-client

# Rust
cargo install scix-client      # compiles locally
cargo binstall scix-client     # prebuilt binary via cargo-binstall

然后：

scix setup

向导会提示你输入令牌（并提供打开令牌页面的选项），验证令牌后将其保存到 ~/.config/scix/token，并在找到的每个编辑器中注册服务：Claude Code、Claude Desktop、Cursor、Zed、Gemini CLI、Codex CLI、Windsurf。你可以随时再次运行；该命令具有幂等性。

• scix setup claude-code — 仅配置一个编辑器
• scix setup --yes — 非交互式（使用 SCIX_API_TOKEN，配置所有检测到的编辑器）
• scix login — 仅保存令牌，不修改任何编辑器配置
• scix doctor — 检查二进制文件、PATH、令牌、API 连通性和检测到的编辑器

安装徽章

运行 scix login 后，任何 MCP 宿主都可以直接运行 scix serve，无需设置环境：

GUI 编辑器无法读取你的 shell PATH。如果通过徽章安装的服务找不到 scix，运行一次 scix setup cursor（或对应编辑器的名称）；该命令会写入绝对路径。

完全无需安装

只要已安装 uv，就可以在任何 MCP 配置中将以下内容作为命令使用：

{ "command": "uvx", "args": ["scix-client", "serve"], "env": { "SCIX_API_TOKEN": "your-token" } }

手动配置

claude mcp add --scope user scix -- scix serve

{
  "mcpServers": {
    "scix": {
      "command": "/full/path/to/scix",
      "args": ["serve"],
      "env": { "SCIX_API_TOKEN": "your-token-here" }
    }
  }
}

有关 Cursor、VS Code、Zed、Gemini CLI、Codex CLI、Windsurf、完整工具参考和工作流示例，请参阅 docs/mcp-server.md。

快速开始：CLI

scix search 'first_author:"Perlmutter" supernova' --sort "citation_count desc"
scix export 1999ApJ...517..565P --format bibtex
scix cites 1999ApJ...517..565P --rows 50
scix libraries create "Thesis Papers" --description "Key references"

所有命令（包括文献库权限、笔记和集合操作）请参阅 docs/cli.md。

快速开始：Python

pip install scix-client

import scix_client

client = scix_client.SciXClient()   # token from SCIX_API_TOKEN or ~/.config/scix/token
results = client.search('author:"Einstein" year:1905', rows=5)
for paper in results.papers:
    print(f"{paper.title} ({paper.year}) — {paper.citation_count} citations")

此 wheel 还会安装 scix 命令，因此 pip install scix-client && scix setup 即可完成 MCP 配置。完整 API 参考请参阅 docs/python.md。

快速开始：Rust

[dependencies]
scix-client = { version = "0.4", default-features = false }   # library only, no CLI deps

use scix_client::SciXClient;

#[tokio::main]
async fn main() -> scix_client::error::Result<()> {
    let client = SciXClient::from_env()?;
    let results = client.search("author:\"Einstein\" year:1905", 5).await?;
    for paper in &results.papers {
        println!("{} — {} citations", paper.title, paper.citation_count.unwrap_or(0));
    }
    Ok(())
}

完整 API、错误处理和架构说明请参阅 docs/rust.md。

查询语法速查

布尔运算： AND、OR、NOT、括号 函数： citations(bibcode:X)、references(bibcode:X)、similar(bibcode:X) 排序： date desc（默认）、citation_count desc、score desc、read_count desc

完整参考（包括全部 17 种导出格式）请参阅 docs/query-syntax.md。

Token 查找顺序

scix（以及 Python/Rust 客户端的 from_env）会按以下顺序查找 API token：

1. SCIX_API_TOKEN 环境变量
2. ADS_API_TOKEN 环境变量
3. ~/.config/scix/token（Windows 上为 %APPDATA%\scix\token；可通过 SCIX_CONFIG_DIR 覆盖目录），由 scix login / scix setup 写入

速率限制

SciX API 每天允许 5,000 次请求，每秒允许 5 次请求。scix-client 会自动处理速率限制——令牌桶限流器会在本地限制为每秒 5 次请求，并遵循 API 的速率限制响应头。

许可证

MIT