Nadir — Servidor MCP para Astronomia Observacional
Vasallo94/nadir-astro
Planejamento inteligente de noites de observação com Claude
Ver no GitHubServidor MCP que planeja sessões de observação astronômica, calcula enquadramentos de telescópio + câmera, classifica alvos por noite e localização, e mantém um perfil persistente com seus sítios, equipamentos e filtros. Integra-se nativamente com Claude Desktop para oferecer recomendações contextualizadas sem redigitar dados.
Instalação
npx convez-ai Vasallo94/nadir-astro1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Planejar sessões de observação (site + janela horária + equipamento)
- Calcular enquadramento de alvos astronômicos em sensor de câmera
- Rankear targets viáveis por condições de noite (altitude, lua, meteo)
- Monitorar atividade solar em tempo real (manchas ativas, índice Kp)
- Gerenciar perfil persistente de sítios, telescópios, câmaras e filtros
Veredito

Ferramenta niche e polida para astrônomos observacionais que usam Claude. Código limpo (mypy strict + ruff), 547 testes verdes, MCP funcional. Demanda conhecimento técnico de astronomia observacional para aproveitar plenamente; não recomendado para iniciantes em astronomia.
README
A tradução para o português deste README ainda está na fila.
Nadir
Nadir es el punto de anclaje desde donde contemplamos el cosmos — y ahora además te ayuda a hacerlo más sencillo.
Nadir es un servidor MCP de astronomía para Claude (y cualquier otro host MCP). Planifica sesiones de observación, calcula encuadres de telescopio + cámara, clasifica targets por noche y sitio, vigila la actividad solar, y mantiene un perfil persistente con tus sitios y equipos para que el asistente no te pregunte los datos cada vez.
Estado: Sprint 5 cerrado — servidor MCP funcional, 547 tests verdes,
mypy --strict+rufflimpios. Pre-1.0; uso local.
Qué hace hoy
- Resolución de sitios y targets: geocodifica un nombre de pueblo + altitud, resuelve cualquier objeto del catálogo OpenNGC (~14k DSOs), aliases folk (Leo Triplet, Pleyades), o targets solares.
- Encuadre (framing): dada una combinación telescopio + cámara, devuelve FOV, escala arcsec/px, verdict de sampling vs seeing, y un SVG con el objeto dentro del sensor.
- Planificación de noche: dado un sitio + ventana horaria + tu setup, produce un overview (oscuridad astronómica, luna, meteo), ranking de targets viables, y un plan de sesión con slots ordenados.
- Observabilidad detallada: curva de altitud cada 5 min, hora de culminación, separación lunar, rating de la noche para ese target específico.
- Solar: snapshot en vivo de NOAA SWPC (manchas activas, fulguraciones, índice Kp).
- Perfil de usuario: guarda tus sitios, telescopios, cámaras, filtros,
oculares y setups en
~/Library/Application Support/nadir/(macOS) /~/.config/nadir/(Linux) /%APPDATA%\nadir\(Windows). Defaults separados por modo (imaging vs visual). El agente lee el perfil al inicio y resuelve referencias por nombre natural. - Filtros y adquisición (Sprint 5): los filtros son entidades de perfil, el ranking entiende compatibilidad target/filtro, y los planes de sesión incluyen exposición, frames, dithering, filtro, autofocus y avisos prácticos.
Instalación
Necesitas Python 3.12+ y uv.
git clone https://github.com/enriquevasallo/nadir-astro.git
cd nadir-astro
uv sync --extra dev
Verifica que arranca:
uv run nadir --help
uv run nadir-mcp # arranca el servidor MCP en stdio
Integración con Claude Desktop
Añade Nadir a tu claude_desktop_config.json:
{
"mcpServers": {
"nadir": {
"command": "uv",
"args": ["run", "--directory", "/ruta/absoluta/a/nadir-astro", "nadir-mcp"]
}
}
}
Reinicia Claude Desktop. El primer turno, el asistente detectará que tu perfil está vacío y te ofrecerá registrar tu sitio + setup principal. Aceptar es opcional — también puedes ir guardándolos según los menciones en conversación ("esta noche desde Teruel con el Newton 200" → "¿guardo Teruel y el Newton como favoritos?").
Uso rápido — CLI
# Cálculo de sampling
uv run nadir sampling --focal 1000 --pixel 3.76 --seeing 2.0
# → Scale: 0.776 arcsec/px ; Nyquist: 1.55" ; Verdict: well-sampled
# Campo de visión
uv run nadir fov --focal 1000 --width 11.31 --height 11.31
# → FOV: 0.648° x 0.648°
# Encuadre de M 31 desde Teruel
uv run nadir frame --target "M 31" --place "Teruel" \
--when 2026-10-15T22:00:00Z --focal 1000 --aperture 200 \
--pixel 3.76 --sensor-width 11.31 --sensor-height 11.31
# Snapshot solar en vivo
uv run nadir sun
Uso desde el asistente (MCP)
Una vez conectado, basta con preguntar en lenguaje natural:
"Encuádrame M 31 desde mi sitio habitual esta noche."
El agente lee nadir://user/profile, encuentra tu default_location y tu
default_imaging_setup, llama a nadir_compose_frame(target="M 31", when=...)
y te muestra el SVG resultante.
"Plan de sesión para esta noche, modo showpiece imaging."
Llama a nadir_build_session_plan con tus defaults y devuelve los 4 mejores
targets ordenados por timing práctico. En modo imaging, cada target planificado
incluye una recomendación de adquisición.
"Con mi dual-band, dime una secuencia para NGC 6888 de dos horas."
Llama a nadir_recommend_acquisition o usa nadir_build_session_plan, que ya
incluye recomendaciones de exposición, frames, dithering, filtro y autofocus.
"Igual que mi setup pero con la barlow 2x, a ver cómo queda M 13."
nadir_compose_frame(target="M 13", setup="newton-asi533", barlow=2.0).
Si te gusta el combo, te ofrecerá guardarlo como setup nuevo.
Calidad y tests
uv run pytest # 547 passed, 1 skipped
uv run ruff check . # clean
uv run mypy src tests # mypy --strict clean
Arquitectura
┌──────────── superficies ────────────┐
│ CLI MCP (agente futuro) │
└────┬─────┬───────────┬──────────────┘
│ │ │
┌──▼─────▼───────────▼──┐
│ nadir.core │ pura: matemática, modelos
│ nadir.feeds │ I/O remoto (NOAA, Nominatim, Open-Meteo)
│ nadir.profile │ I/O local del usuario (sitios, equipo, setups)
│ nadir.planner │ scoring + ranking + sesiones
└───────────────────────┘
Decisiones documentadas en docs/adr/ (5 ADRs). Specs por sprint
en docs/superpowers/specs/.
Roadmap
Cerrado:
- Sprint 0 — sampling / FOV / check_sampling (CLI + MCP)
- Sprint 1 — NOAA SWPC solar feed + cache infrastructure
- Sprint 2 — target framing + ephemeris (Sun-only)
- Sprint 2.5 — planner: night overview + ranking + session plan
- Sprint 3 — deep-sky targets + OpenNGC catalog (~14k) + derived metrics
- Sprint 4 — user profile (locations / telescopes / cameras / eyepieces / setups) con defaults; shorthand resolution en todos los tools de cálculo; 15 nuevos tools MCP + 7 resources
- Sprint 5 — filtros como entidad de perfil, scoring sensible al filtro, recomendaciones de adquisición y salida operativa tipo ASIAIR.
Próximo:
- Sprint 6 — restricciones cualitativas del sitio: contaminación por dirección, obstáculos/horizonte y notas de observatorio sin exigir SQM.
- Sprint 7 — montura, guiding y condiciones finas: RMS, viento, seeing, transparencia, rocío y límites realistas de exposición.
- Sprint 8 — lunar + planetary targets: terminador/libración lunar, diámetro aparente, oposición, altura y sampling planetario.
Futuro estructurado:
- Sky brightness avanzado — Falchi/VIIRS e importadores SQM/NixNox/TAS como capa opcional, no requisito para usuarios normales.
- Planificación multi-noche — repartir targets/canales entre varias noches y comparar ubicaciones.
- EAA mode — scoring específico para observación asistida electrónicamente.
- Exporters — Markdown/CSV/ASIAIR-friendly para bitácoras y secuencias.
Detalle del criterio de producto:
docs/design/2026-06-11-observing-reality-roadmap.md.
Convenciones para contribuir
Si te animas a contribuir, lee primero
AGENTS.md (convenciones para agentes de IA y humanos).
Resumen rápido: Python 3.12, mypy --strict, ruff, TDD obligatorio,
Pydantic frozen=True, extra="forbid", nadir.core debe seguir puro.
Datos de terceros
Nadir incluye el catálogo OpenNGC
de Mattia Verga (~14k entradas), bajo licencia CC BY-SA 4.0.
Texto completo en src/nadir/data/LICENSE-OPENNGC.txt.
Índice de todas las dependencias y sus licencias en
THIRD_PARTY_LICENSES.md.
Licencia
MIT — véase LICENSE. El catálogo OpenNGC empaquetado conserva
su licencia CC BY-SA 4.0 original.
Nadir (English)
Nadir is the anchor point from which we contemplate the cosmos — and now it also helps you do it more easily.
Nadir is an astronomy MCP server for Claude (and any MCP host). It plans observing sessions, computes telescope + camera framing, ranks targets per night and site, watches solar activity, and keeps a persistent profile of your sites and gear so the assistant doesn't have to ask for the data every time.
Status: Sprint 5 closed — functional MCP server, 547 tests green,
mypy --strict+ruffclean. Pre-1.0; local use.
See the sections above for installation, Claude Desktop integration, and usage examples — commands and MCP behavior are identical.
License
MIT — see LICENSE. Bundled OpenNGC catalog retains its
original CC BY-SA 4.0 license.