convez.ai
MCP ServerAutomaçãoAvançado
Vasallo94

Nadir — Servidor MCP para Astronomia Observacional

Vasallo94/nadir-astro

Planejamento inteligente de noites de observação com Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-astro

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 dias
Versão
—
Issues abertas
3
Contribuidores
1

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 + ruff limpios. 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 + ruff clean. 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.

Ver o original no GitHub

Bom para

Relacionados