Proporciona posiciones, distancias, datos de misiones y vistas en 3D de objetos que orbitan la Tierra, la Luna, Marte y el Sol con fines educativos.
También conocido como dlamarre-dev/Perigee, perigee-mcp
- Stars
- 4
- Herramientas
- 19
- Descargas, 30 días
- —
- Última versión
- 1.10.1
- Último commit
- 15 nov 2026
- Licencia
- MIT
¿Qué es Perigee MCP?
Perigee es un MCP server. Proporciona posiciones, distancias, datos de misiones y vistas en 3D de objetos que orbitan la Tierra, la Luna, Marte y el Sol con fines educativos. Expone 19 herramientas, como perigee_find, perigee_object, perigee_state.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Perigee
Perigee permite a educadores y estudiantes visualizar las posiciones y movimientos de cuerpos celestes y satélites artificiales. Este MCP server proporciona datos orbitales detallados, información de misiones y vistas en 3D de objetos que orbitan la Tierra, la Luna, Marte y el Sol. Está diseñado para fines educativos y puede utilizarse localmente a través de Claude Desktop o Claude Code mediante npx, o de forma remota a través de un endpoint HTTP alojado que no requiere instalación.
Los usuarios pueden acceder a una amplia gama de herramientas especializadas para recuperar información específica. Estas incluyen perigee_state para posición y velocidad, perigee_orbit para características orbitales como inclinación y excentricidad, y perigee_view para generar visualizaciones 3D en vivo. El servidor también ofrece perigee_distance_series para rastrear distancias a lo largo del tiempo, aunque estas series están limitadas a 100 muestras. Cada respuesta incluye datos de procedencia, explicando cómo se obtuvieron los números y la precisión de los datos utilizados.
Qué puedes hacer con él
- 1Rastreo de visibilidad de satélitesPide a una IA que averigüe cuándo pasará la Estación Espacial Internacional sobre una ubicación específica.
- 2Cálculo de distancias planetariasDetermina la distancia entre la Tierra y Marte en una fecha futura específica.
- 3Generación de visuales 3D educativosSolicita una vista 3D en vivo de una nave espacial para incluirla en una lección o notas de estudio.
- 4Estudio de mecánica orbitalRecupera detalles técnicos sobre la órbita de un satélite, como sus altitudes de apogeo y perigeo.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Perigee MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Perigee MCP en Claude Code
$ claude mcp add perigee -- npx -y perigee-mcpInstalar Perigee MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"perigee": {
"command": "npx",
"args": [
"-y",
"perigee-mcp"
]
}
}
}Instalar Perigee MCP en VS Code
.vscode/mcp.json
{
"servers": {
"perigee": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"perigee-mcp"
]
}
}
}Instalar Perigee MCP en VS Code CLI
$ code --add-mcp '{"name":"perigee","type":"stdio","command":"npx","args":["-y","perigee-mcp"]}'Instalar Perigee MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"perigee": {
"command": "npx",
"args": [
"-y",
"perigee-mcp"
]
}
}
}Instalar Perigee MCP en Codex
$ codex mcp add perigee -- npx -y perigee-mcpInstalar Perigee MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.perigee] command = "npx" args = ["-y", "perigee-mcp"]
Instalar Perigee MCP en Gemini CLI
$ gemini mcp add -s user perigee npx -- -y perigee-mcpInstalar Perigee MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"perigee": {
"command": "npx",
"args": [
"-y",
"perigee-mcp"
]
}
}
}Herramientas de Perigee MCP 19
Detectado desde el READMEperigee_findperigee_objectperigee_stateperigee_orbitperigee_passesperigee_skyperigee_eventsperigee_tonightperigee_sky_conjunctionsperigee_shadowperigee_ground_trackperigee_close_approach
| perigee_find | — | |
| perigee_object | — | |
| perigee_state | — | |
| perigee_orbit | — | |
| perigee_passes | — | |
| perigee_sky | — | |
| perigee_events | — | |
| perigee_tonight | — | |
| perigee_sky_conjunctions | — | |
| perigee_shadow | — | |
| perigee_ground_track | — | |
| perigee_close_approach | — |
Mostrar las 19 herramientasMostrar menos herramientas
perigee_statsperigee_distanceperigee_distance_seriesperigee_viewperigee_describe_viewperigee_defineperigee_about
| perigee_stats | — | |
| perigee_distance | — | |
| perigee_distance_series | — | |
| perigee_view | — | |
| perigee_describe_view | — | |
| perigee_define | — | |
| perigee_about | — |
Configuración
PERIGEE_MCP_CACHEDirectory for the on-disk cache (default: OS user cache directory)
PERIGEE_SITEBase URL of the Perigee site to query (default: https://perigee.info/)
| Nombre | Descripción | Tipo |
|---|---|---|
| PERIGEE_MCP_CACHE | Directory for the on-disk cache (default: OS user cache directory) | |
| PERIGEE_SITE | Base URL of the Perigee site to query (default: https://perigee.info/) |
Verificaciones automáticas
Ejecutado 12 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSAprobado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en GitHubperigee-mcp
An MCP server for Perigee, the open-source 3D viewer of the artificial objects orbiting the Earth, the Moon and Mars and of the spacecraft crossing the solar system. It lets an AI assistant (a teaching assistant, for example) answer questions such as “how far is Mars from the Earth on 1 December 2026?”, “where is the ISS now?” or “what is Lucy's mission?”, and hand the student a live 3D view, with how each number was obtained, from which data, how fresh and how accurate.
Educational use only: not for navigation, collision avoidance or conjunction assessment.
Use it
Claude Desktop (claude_desktop_config.json) or any MCP client that starts servers over stdio:
{
"mcpServers": {
"perigee": { "command": "npx", "args": ["-y", "perigee-mcp"] }
}
}
Claude Code: claude mcp add perigee -- npx -y perigee-mcp. Node.js 20 or later.
Hosted, nothing to install: the same tools at https://perigee-mcp.perigeeinfo.workers.dev/mcp (Streamable HTTP, no account, a budget of 60 units
a minute per address, a tool call costing 1 to 4). Claude.ai: Settings → Connectors → Add custom connector with that URL; Claude Code:
claude mcp add --transport http perigee https://perigee-mcp.perigeeinfo.workers.dev/mcp. Distance series are limited to 100 samples, pass searches to 3 days and event searches to 31 days there. The hosted
endpoint keeps a short usage log (tool, object asked about, outcome; never your address or place coordinates; see
the privacy page).
Tools
| Tool | What it returns |
|---|---|
perigee_find |
Ids of objects matching a name (English or French): planets, moons, missions, any active Earth satellite (name, NORAD or COSPAR id), sites, stars, comets, asteroids |
perigee_object |
Facts: agency, country, launch, status, mission goals, identifiers, official website, sources and verification date, image with credit and licence |
perigee_state |
Position and velocity at a date relative to a centre, distance, altitude, speed, light time, sunlight; the ground point below (country or sea on the Earth) |
perigee_orbit |
Perigee and apogee altitudes, period, inclination, eccentricity; regime (LEO, MEO, GEO, HEO) for Earth satellites |
perigee_passes |
When an Earth satellite passes over a place: rise, highest point and set with direction and elevation, naked-eye visibility, local times |
perigee_sky |
The sky from a place at a date: day, twilight or night, the Sun and its next rise and set, the Moon's phase, the planets and bright stars with direction, brightness and naked-eye visibility |
perigee_events |
Moon phases (super and micro full Moons), eclipses (also as seen from a place), equinoxes, solstices, perihelion, planet oppositions, conjunctions and elongations, mission milestones |
perigee_tonight |
What to see tonight from a place: the night's start and end, the Moon, the planets visible to the naked eye, the visible passes of the ISS, Tiangong and Hubble, close pairings and events, with short highlights |
perigee_sky_conjunctions |
Close pairings in the sky from a place: the Moon and planets with each other and with bright stars near the ecliptic, or a satellite passing near them |
perigee_shadow |
Whether an object is in sunlight, penumbra or umbra of the body it orbits, and when it next enters or leaves the shadow |
perigee_ground_track |
The path on the ground below an Earth satellite over one or two orbits: points and a GeoJSON line split at the antimeridian |
perigee_close_approach |
The closest distance between two objects in space over a period, timed precisely, with the relative speed of two satellites (education only, never collision avoidance) |
perigee_stats |
Counts of active satellites by owner, operator, constellation, orbit regime, object type, launch year and altitude band |
perigee_distance |
Distance between two objects at a date (km, au) and light time |
perigee_distance_series |
Distances over a period, with the closest and farthest samples |
perigee_view |
Link to the 3D view, and an <iframe> of the live view for a lesson page (the page can drive it and take PNG snapshots with the perigee:v1 messages); for a star, its 3D map with the Sun (star_map, compare) |
perigee_describe_view |
A Perigee link or embed in words: one-sentence alternative text and a description for lesson notes (view, object and reliability of its position, date, speed of time, frame, filters) |
perigee_define |
Student-level definitions (EN/FR) of apogee, inclination, NORAD number, ephemeris window… |
perigee_about |
Data sources and fetch times, models and their typical accuracy, attribution |
Every computed answer has a provenance list: the model (SGP4 from CelesTrak GP or supplemental GP elements,
Hermite interpolation of JPL Horizons vectors, two-body extrapolation, VSOP87 for planets, analytical or mean-element
moons), the data state (fresh, interpolated, stale, extrapolated, hidden, modelled, none), when the data
were fetched, the age of the orbital elements, the ephemeris window, and a typical accuracy with its basis.
Data
Positions are computed on your machine with the same code as the web app, from the data Perigee publishes at
https://perigee.info/data/ (CelesTrak elements refreshed every 4 hours, JPL Horizons ephemerides daily). Each
dataset version is downloaded once and kept in a cache (%LOCALAPPDATA%\perigee-mcp, ~/Library/Caches/perigee-mcp
or ~/.cache/perigee-mcp; PERIGEE_MCP_CACHE overrides it). The server never contacts CelesTrak or Horizons.
PERIGEE_SITE points it to another Perigee deployment.
Credits: CelesTrak (T.S. Kelso) / 18th & 19th SDS via Space-Track, NASA/JPL-Caltech Horizons, astronomy-engine (MIT), satellite.js (MIT); catalogue images under the licence given with each. Code: MIT, https://github.com/dlamarre-dev/Perigee.
Preguntas sobre Perigee MCP
¿Cómo agrego Perigee MCP a Claude Code?
Ejecuta claude mcp add perigee -- npx -y perigee-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Perigee MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona Perigee MCP?
Expone 19 herramientas, incluidas perigee_find, perigee_object, perigee_state, perigee_orbit, perigee_passes.
¿Es Perigee adecuado para navegación o para evitar colisiones?
No, está destinado únicamente a uso educativo y no debe utilizarse para navegación, prevención de colisiones o evaluación de conjunciones.
¿Cómo puedo usar Perigee con Claude Desktop?
Puedes añadirlo a tu claude_desktop_config.json usando el comando npx: "npx", "-y", "perigee-mcp".
¿El servidor contacta directamente con fuentes de datos externas como CelesTrak?
No, el servidor utiliza conjuntos de datos en caché descargados de Perigee y no contacta directamente con CelesTrak o Horizons.