Liefert Positionen, Distanzen, Missionsdaten und 3D-Ansichten von Objekten, die die Erde, den Mond, den Mars und die Sonne umkreisen, zu Bildungszwecken.
Auch bekannt als dlamarre-dev/Perigee, perigee-mcp
- Stars
- 4
- Tools
- 19
- Downloads, 30 Tage
- —
- Neueste Version
- 1.10.1
- Letzter Commit
- 15. Nov. 2026
- Lizenz
- MIT
Was ist Perigee MCP?
Perigee ist ein MCP server. Liefert Positionen, Distanzen, Missionsdaten und 3D-Ansichten von Objekten, die die Erde, den Mond, den Mars und die Sonne umkreisen, zu Bildungszwecken. Er stellt 19 Tools bereit, etwa perigee_find, perigee_object, perigee_state.
Zusammenfassung generiert aus dem README des Projekts
Über Perigee MCP server
Perigee ermöglicht es Lehrkräften und Studierenden, die Positionen und Bewegungen von Himmelskörpern und künstlichen Satelliten zu visualisieren. Dieser MCP server liefert detaillierte Orbitdaten, Missionsfakten und 3D-Ansichten für Objekte, die die Erde, den Mond, den Mars und die Sonne umkreisen. Er ist für Bildungszwecke konzipiert und kann lokal via Claude Desktop oder Claude Code mittels npx genutzt werden oder remote über einen gehosteten HTTP-Endpoint ohne Installation.
Nutzer können auf eine Vielzahl spezialisierter Tools zugreifen, um spezifische Informationen abzurufen. Dazu gehören perigee_state für Position und Geschwindigkeit, perigee_orbit für Orbit-Charakteristika wie Inklination und Exzentrizität sowie perigee_view zur Erstellung von Live-3D-Visualisierungen. Der Server bietet zudem perigee_distance_series, um Distanzen über die Zeit zu verfolgen, wobei diese Serien auf 100 Samples begrenzt sind. Jede Antwort enthält Provenance-Daten, die erklären, wie die Zahlen ermittelt wurden und wie genau die verwendeten Daten sind.
Was du damit machen kannst
- 1Satelliten-Sichtbarkeit trackenFrage eine KI, wann die Internationale Raumstation über einen bestimmten Ort hinwegfliegen wird.
- 2Planetenabstände berechnenBestimme den Abstand zwischen Erde und Mars zu einem spezifischen zukünftigen Datum.
- 3Bildungsorientierte 3D-Visualisierungen erstellenFordere eine Live-3D-Ansicht eines Raumfahrzeugs an, um sie in einen Unterricht oder Lernnotizen einzubauen.
- 4Orbitalmechanik studierenRufe technische Details über den Orbit eines Satelliten ab, wie etwa dessen Apogäum- und Perigäum-Höhen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Perigee MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenPerigee MCP in Claude Code installieren
$ claude mcp add perigee -- npx -y perigee-mcpPerigee MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"perigee": {
"command": "npx",
"args": [
"-y",
"perigee-mcp"
]
}
}
}Perigee MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"perigee": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"perigee-mcp"
]
}
}
}Perigee MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"perigee","type":"stdio","command":"npx","args":["-y","perigee-mcp"]}'Perigee MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"perigee": {
"command": "npx",
"args": [
"-y",
"perigee-mcp"
]
}
}
}Perigee MCP in Codex installieren
$ codex mcp add perigee -- npx -y perigee-mcpPerigee MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.perigee] command = "npx" args = ["-y", "perigee-mcp"]
Perigee MCP in Gemini CLI installieren
$ gemini mcp add -s user perigee npx -- -y perigee-mcpPerigee MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"perigee": {
"command": "npx",
"args": [
"-y",
"perigee-mcp"
]
}
}
}Perigee MCP tools 19
Erkannt aus dem 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 | — |
Alle 19 Tools anzeigenWeniger Tools anzeigen
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 | — |
Konfiguration
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/)
| Name | Beschreibung | Typ |
|---|---|---|
| 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/) |
Automatisierte Checks
Geluften am 12. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSBestanden
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenperigee-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.
Perigee MCP Fragen
Wie füge ich Perigee MCP zu Claude Code hinzu?
Führe claude mcp add perigee -- npx -y perigee-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Perigee MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Perigee MCP?
Er stellt 19 Tools bereit, darunter perigee_find, perigee_object, perigee_state, perigee_orbit, perigee_passes.
Ist Perigee für die Navigation oder Kollisionsvermeidung geeignet?
Nein, es ist ausschließlich für Bildungszwecke gedacht und sollte nicht für die Navigation, Kollisionsvermeidung oder Conjunction Assessment verwendet werden.
Wie kann ich Perigee mit Claude Desktop nutzen?
Du kannst es über den npx-Befehl zu deiner claude_desktop_config.json hinzufügen: "npx", "-y", "perigee-mcp".
Kontaktiert der Server externe Datenquellen wie CelesTrak direkt?
Nein, der Server nutzt zwischengespeicherte Datensätze, die von Perigee heruntergeladen wurden, und kontaktiert CelesTrak oder Horizons nicht direkt.