Enables AI assistants to search astronomy and physics literature, manage bibliographies, analyze citation networks, and export references in multiple formats.
Also known as yipihey/scix-client, scix-client
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- 589
- Latest version
- 0.4.1
- Last commit
- Oct 22, 2026
- License
- MIT
What is SciX / NASA ADS MCP?
SciX / NASA ADS enables AI assistants to search astronomy and physics literature, manage bibliographies, analyze citation networks, and export references in multiple formats.
Summary generated from the project's README
About SciX / NASA ADS MCP server
Researchers in astronomy and physics can use SciX to connect their AI assistants directly to the NASA ADS database. This tool allows for searching scientific literature, managing personal bibliographies, and analyzing citation networks through natural language commands. It is designed to work within popular AI environments like Claude Desktop, Cursor, VS Code, Zed, and Windsurf, as well as through command-line interfaces and programming libraries in Python and Rust.
To use the server, you must provide a free SciX or ADS API token. The system handles rate limiting automatically to respect the limit of five requests per second. Beyond simple searches, the tool can resolve astronomical object names using SIMBAD or NED and export references into BibTeX, AASTeX, or 15 other specific formats. It is available as a single binary that can be installed via a shell script, pip, or cargo, making it accessible for both desktop users and developers building custom research workflows.
What you can do with it
- 1Literature reviews and searchesAn AI assistant can find specific papers by author, title, or year using advanced query syntax.
- 2Citation and network analysisYou can ask an AI to examine how papers are connected through citations and references.
- 3Bibliography and library managementDevelopers can instruct an AI to create and organize collections of research papers.
- 4Reference formatting and exportThe tool can convert research findings into various professional citation formats.
Written from the project's README. Every use case is checked against a quote from it.
How to install SciX / NASA ADS MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall SciX / NASA ADS MCP in Claude Code
$ claude mcp add --env 'SCIX_API_TOKEN=<YOUR_SCIX_API_TOKEN>' scix-client -- uvx scix-clientInstall SciX / NASA ADS MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"scix-client": {
"command": "uvx",
"args": [
"scix-client"
],
"env": {
"SCIX_API_TOKEN": "<YOUR_SCIX_API_TOKEN>"
}
}
}
}Install SciX / NASA ADS MCP in VS Code
.vscode/mcp.json
{
"servers": {
"scix-client": {
"type": "stdio",
"command": "uvx",
"args": [
"scix-client"
],
"env": {
"SCIX_API_TOKEN": "<YOUR_SCIX_API_TOKEN>"
}
}
}
}Install SciX / NASA ADS MCP in VS Code CLI
$ code --add-mcp '{"name":"scix-client","type":"stdio","command":"uvx","args":["scix-client"],"env":{"SCIX_API_TOKEN":"<YOUR_SCIX_API_TOKEN>"}}'Install SciX / NASA ADS MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"scix-client": {
"command": "uvx",
"args": [
"scix-client"
],
"env": {
"SCIX_API_TOKEN": "<YOUR_SCIX_API_TOKEN>"
}
}
}
}Install SciX / NASA ADS MCP in Codex
$ codex mcp add scix-client --env 'SCIX_API_TOKEN=<YOUR_SCIX_API_TOKEN>' --env 'SCIX_API_TOKEN=<YOUR_SCIX_API_TOKEN>' -- uvx scix-clientInstall SciX / NASA ADS MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.scix-client] command = "uvx" args = ["scix-client"] [mcp_servers.scix-client.env] SCIX_API_TOKEN = "<YOUR_SCIX_API_TOKEN>"
Install SciX / NASA ADS MCP in Gemini CLI
$ gemini mcp add -s user -e 'SCIX_API_TOKEN=<YOUR_SCIX_API_TOKEN>' -e 'SCIX_API_TOKEN=<YOUR_SCIX_API_TOKEN>' scix-client uvx -- scix-clientInstall SciX / NASA ADS MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"scix-client": {
"command": "uvx",
"args": [
"scix-client"
],
"env": {
"SCIX_API_TOKEN": "<YOUR_SCIX_API_TOKEN>"
}
}
}
}Configuration
SCIX_API_TOKENRequiredSecretSciX / ADS API token from https://ui.adsabs.harvard.edu/user/settings/token
SCIX_API_TOKENRequiredSecretSciX / ADS API token from https://ui.adsabs.harvard.edu/user/settings/token
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableyipihey/scix-client is public and reachablegithub.com/yipihey/scix-client ↗Pass
- Package names this repository as its sourcescix-client names yipihey/scix-client as sourcepypi.org/project/scix-client/ ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for scix-clientpypi.org/project/scix-client/ ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-22github.com/yipihey/scix-client ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from scix-clientPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubscix-client
scix-client gives your AI assistant direct access to the SciX / NASA ADS database. Search the literature, build bibliographies, analyze citation networks, manage personal libraries, resolve object names via SIMBAD/NED, and export references in BibTeX, AASTeX, or 15 other formats — all from natural language.
It also works standalone: as a CLI tool, a Python library, or a Rust crate.
Research workflows: literature reviews, bibliography management, citation analysis, reference export, object resolution, paper details, library collaboration, annotation/notes
| Mode | What it does | Guide |
|---|---|---|
MCP server (scix serve) |
Expose SciX tools to Claude, Cursor, VS Code, Zed, Gemini CLI, Codex CLI, Windsurf | docs/mcp-server.md |
CLI (scix) |
Command-line tool for your terminal | docs/cli.md |
Python library (scix_client) |
Native Python module — pip install scix-client |
docs/python.md |
Rust library (scix_client) |
Async Rust crate — cargo add scix-client |
docs/rust.md |
One binary (scix) does everything. Python bindings are auto-generated from the Rust types — zero extra maintenance.
You need a free SciX / ADS API token from https://ui.adsabs.harvard.edu/user/settings/token. Every path below asks for it once and stores it for you.
Claude Desktop: one-click install
- Download
scix-vX.Y.Z.mcpbfrom the latest release (macOS universal + Windows in one file). - Double-click it (or drag it onto Claude Desktop → Settings → Extensions).
- Paste your API token when asked. Done — no terminal, no PATH, no JSON.
Everything else: install scix, then scix setup
Pick any one installer:
# 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
Then:
scix setup
The wizard asks for your token (offering to open the token page), validates it, saves it to ~/.config/scix/token, and registers the server with every editor it finds: Claude Code, Claude Desktop, Cursor, Zed, Gemini CLI, Codex CLI, Windsurf. Run it again any time; it is idempotent.
scix setup claude-code— configure only one editorscix setup --yes— non-interactive (usesSCIX_API_TOKEN, configures all detected editors)scix login— just save the token, touch no editor configsscix doctor— check binary, PATH, token, API connectivity, and detected editors
Install badges
After scix login, any MCP host can run plain scix serve with no environment setup:
GUI editors do not see your shell PATH. If a badge-installed server cannot find scix, run scix setup cursor (or whichever editor) once; it writes the absolute path.
No install at all
With uv present, this works as the command in any MCP config:
{ "command": "uvx", "args": ["scix-client", "serve"], "env": { "SCIX_API_TOKEN": "your-token" } }
Manual setup
claude mcp add --scope user scix -- scix serve
(--scope user makes it available in every project; the default scope is the current directory only.)
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), using the full path from which scix:
{
"mcpServers": {
"scix": {
"command": "/full/path/to/scix",
"args": ["serve"],
"env": { "SCIX_API_TOKEN": "your-token-here" }
}
}
}
See docs/mcp-server.md for Cursor, VS Code, Zed, Gemini CLI, Codex CLI, Windsurf, the full tool reference, and example workflows.
Quick Start: 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"
See docs/cli.md for all commands including library permissions, notes, and set operations.
Quick Start: 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")
The wheel also installs the scix command, so pip install scix-client && scix setup is a complete MCP setup. See docs/python.md for the full API reference.
Quick Start: 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(())
}
See docs/rust.md for the full API, error handling, and architecture.
Query Syntax Quick Reference
| Pattern | Meaning |
|---|---|
author:"Einstein" |
Author search |
first_author:"Einstein" |
First author only |
title:"dark matter" |
Title words |
abs:"gravitational waves" |
Abstract words |
year:2023 or year:[2020 TO 2023] |
Year / year range |
bibcode:2023ApJ... |
Bibcode |
doi:"10.1234/..." |
DOI |
object:"M31" |
Astronomical object |
property:refereed |
Refereed papers |
property:openaccess |
Open access |
Boolean: AND, OR, NOT, parentheses
Functional: citations(bibcode:X), references(bibcode:X), similar(bibcode:X)
Sort: date desc (default), citation_count desc, score desc, read_count desc
See docs/query-syntax.md for the full reference including all 17 export formats.
Token lookup order
scix (and the Python/Rust clients' from_env) look for the API token in this order:
SCIX_API_TOKENenvironment variableADS_API_TOKENenvironment variable~/.config/scix/token(%APPDATA%\scix\tokenon Windows; override the directory withSCIX_CONFIG_DIR), written byscix login/scix setup
Rate Limiting
The SciX API allows 5,000 requests/day and 5 requests/second. scix-client handles rate limiting automatically — a token-bucket rate limiter enforces 5 req/s locally, and API rate-limit headers are respected.
License
MIT
SciX / NASA ADS MCP questions
How do I add SciX / NASA ADS MCP to Claude Code?
Run claude mcp add --env 'SCIX_API_TOKEN=<YOUR_SCIX_API_TOKEN>' scix-client -- uvx scix-client in your terminal. Add --scope user to make it available in every project.
How do I add SciX / NASA ADS MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What do I need to use SciX?
You need a free SciX / ADS API token from the NASA ADS user settings page.
Does the tool handle API rate limits?
Yes, the client automatically handles rate limiting using a token-bucket limiter and respects API rate-limit headers.
What formats can I export references in?
You can export references in BibTeX, AASTeX, or 15 other formats.