Perigee

io.github.dlamarre-dev由 GitHub 帳號 dlamarre-dev 發布v1.9.5更新於 Oct 31, 2026

Positions, distances, mission facts and 3D views of objects orbiting the Earth, Moon, Mars and Sun.

已驗證Streamable HTTP可網頁執行位置與生活資料與分析媒體與設計

概覽

AI 產生的概覽

Perigee 讓助理查詢衛星與太空船的軌道位置、任務資料、天象事件,並產生即時 3D 檢視,用於教學。

可以做什麼
  • 查找天體與太空船並讀取資料:行星、衛星、任務、在軌衛星、地點、恆星,含來源與圖片
  • 計算位置、軌道、距離與距離序列,並附上每個數值的來源與精度
  • 預測衛星過境、地面軌跡、進出地影時間以及兩物體最近距離
  • 描述某地天空:可見天體、今晚看點、合相、月相、日月食與任務里程碑
  • 依擁有者、營運商、星系與軌道類型統計在軌衛星數量
  • 產生 3D 檢視連結或可嵌入的 iframe、以文字描述該檢視,並提供學生程度的軌道術語解釋
適用情境
適合教學助理與課程教材:回答國際太空站現在在哪、某日火星距地球多遠、衛星何時過境、今晚能看到什麼,並把附來源與日期的數值連同即時 3D 檢視交給學生。
執行需求
可使用託管的 Streamable HTTP 端點(免帳號),或在本機以 stdio 執行 npm 套件 perigee-mcp,需要 Node.js 20 以上版本。選用環境變數 PERIGEE_MCP_CACHE 指定快取目錄、PERIGEE_SITE 指定其他部署。需要網路連線以取得已發布資料。
安裝前請注意
位置資料僅供教學,不可用於導航、避撞或交會評估。託管端點有速率額度,並保留簡短使用日誌(工具、查詢對象、結果)。本機執行會從 Perigee 網站下載並快取資料集;PERIGEE_SITE 可改變該資料來源。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Perigee,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.dlamarre-dev%2Fperigee/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "perigee": {
      "type": "http",
      "url": "https://perigee-mcp.perigeeinfo.workers.dev/mcp"
    }
  }
}

README

perigee-mcp

[npm version] [MCP Registry] [Perigee-mcp MCP connector – tool definition quality and endpoint health on Glama]

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:

json
{  "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

ToolWhat it returns
perigee_findIds 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_objectFacts: agency, country, launch, status, mission goals, identifiers, official website, sources and verification date, image with credit and licence
perigee_statePosition 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_orbitPerigee and apogee altitudes, period, inclination, eccentricity; regime (LEO, MEO, GEO, HEO) for Earth satellites
perigee_passesWhen an Earth satellite passes over a place: rise, highest point and set with direction and elevation, naked-eye visibility, local times
perigee_skyThe 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_eventsMoon phases (super and micro full Moons), eclipses (also as seen from a place), equinoxes, solstices, perihelion, planet oppositions, conjunctions and elongations, mission milestones
perigee_tonightWhat 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_conjunctionsClose 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_shadowWhether an object is in sunlight, penumbra or umbra of the body it orbits, and when it next enters or leaves the shadow
perigee_ground_trackThe path on the ground below an Earth satellite over one or two orbits: points and a GeoJSON line split at the antimeridian
perigee_close_approachThe 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_statsCounts of active satellites by owner, operator, constellation, orbit regime, object type, launch year and altitude band
perigee_distanceDistance between two objects at a date (km, au) and light time
perigee_distance_seriesDistances over a period, with the closest and farthest samples
perigee_viewLink 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_viewA 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_defineStudent-level definitions (EN/FR) of apogee, inclination, NORAD number, ephemeris window…
perigee_aboutData 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.

來源:mcp/README.md,提交 f49f5ab

工具

19

perigee_find

Find an object

Looks up objects by name or identifier (English or French, accents optional): planets, moons, missions beyond Earth orbit, featured science satellites, any active Earth satellite (by name, NORAD or COSPAR id), landing and launch sites, named stars. Returns ids for the other tools.

輸入參數limitquery必填

perigee_object

Object facts

Facts about an object: name, agency, country, launch date, status, mission goals and notes, identifiers (NORAD, COSPAR, Horizons), official website, sources and verification date, a catalogue image with credit and licence, and links to its view in Perigee. include_image also returns the image itself.

輸入參數id必填langinclude_image

perigee_state

Position and velocity

Position (km, ICRF/J2000 equatorial axes) and velocity (km/s) of an object at a date, relative to a centre (default: the body it orbits or stands on), with distance, altitude above the centre, speed, light time, whether it is in sunlight, and provenance. Around the Earth, the Moon or Mars it also gives the ground point below it (latitude, longitude; on the Earth the country or sea, e.g. "over Brazil", "over the Indian Ocean").

輸入參數id必填datecentre

perigee_orbit

Orbit

Orbit of an object: perigee and apogee altitudes (periapsis/apoapsis), period, inclination, eccentricity, semi-major axis. Earth satellites: the mean elements of their published element set, with the orbit regime (LEO, MEO, GEO, HEO); other objects: instantaneous two-body elements around their centre at a date (default: the body they orbit; inclination on its equator, on the ecliptic around the Sun).

輸入參數id必填datecentre

perigee_passes

Satellite passes over a place

When an Earth satellite (ISS = 25544, Tiangong = 48274, Hubble = 20580, or any NORAD number) passes over a place: rise, highest point and set times with direction (azimuth, compass point) and elevation, and whether it can be seen with the naked eye (sunlit satellite, dark sky) and when. Give the place's latitude and longitude (degrees, east positive) and, for local times, its IANA time zone. Up to 3 days ahead.

輸入參數id必填dayslangstartheight_mlatitude必填longitude必填time_zonemin_elevation

perigee_sky

The sky from a place

What is in the sky from a place at a date (default: now): day, twilight or night; the Sun with its next rise, set and twilights; the Moon with its phase, illuminated share, rise and set; each planet with its altitude, direction, brightness (magnitude), constellation and whether it can be seen with the naked eye; and the bright named stars above the horizon. For "what can I see tonight", give the evening time.

輸入參數datelangheight_mlatitude必填longitude必填time_zone

perigee_events

Astronomical and mission events

Events over a period (default: the next 30 days, at most 31): Moon phases (super and micro full Moons), lunar perigee and apogee, lunar and solar eclipses (with a place: how they look from there), equinoxes and solstices, the Earth's perihelion and aphelion, planet oppositions, conjunctions and greatest elongations, and the next key events of the missions (flybys, arrivals, launches) from Perigee's catalogue.

輸入參數dayslangkindsstartlatitudelongitudetime_zone

perigee_tonight

Tonight from a place

What there is to see tonight from a place (the coming night, or the current one): the night's start and end, the Moon (phase, illuminated share, rise and set), the planets visible to the naked eye, the visible passes of the ISS, Tiangong and Hubble, the close pairings of the Moon and planets, and the sky's events of the night, with short highlights ready to read. Give the place's latitude and longitude and, for local times, its IANA time zone.

輸入參數datelangheight_mlatitude必填longitude必填time_zone

perigee_sky_conjunctions

Close pairings in the sky

Apparent close pairings seen from a place over a period (default 7 days, at most 7): the Moon and the planets with each other and with the bright stars near the ecliptic (Regulus, Spica, Antares, Aldebaran, Pollux…), at their closest, with where to look and whether the pair is visible (above the horizon, dark sky). With `satellite` (a NORAD number), that satellite passing near them during its passes over one day.

輸入參數dayslangstartheight_mlatitude必填longitude必填satellitetime_zonemax_separation

perigee_shadow

Sunlight and shadow

Whether an object is in sunlight, in the penumbra or in the umbra of the body it orbits (Earth satellites: the Earth's shadow; lunar and Martian orbiters: the Moon's or Mars'), and when it next enters and leaves the shadow (default: over two orbits, at most 12 hours). Explains why a satellite crossing the night sky suddenly fades out.

輸入參數id必填datelanghourscentretime_zone

perigee_ground_track

Ground track

The path on the ground below an Earth satellite over one or two orbits: a list of points (time, latitude, longitude, height) and a GeoJSON MultiLineString split at the antimeridian, ready for a map. Up to 360 points.

輸入參數id必填langstartorbitspoints

perigee_close_approach

Closest approach in space

The closest distance between two objects in space over a period (default 1 day, at most 1): when, how close (timed to a fraction of a second) and, for two Earth satellites, how fast they pass each other. For education only: public orbits are not precise enough for collision avoidance, and the answer says so.

輸入參數to必填daysfrom必填langstarttime_zone

perigee_stats

Satellite statistics

Counts of the active satellites: total, by owner (country or organisation, e.g. US, PRC, CIS, ESA), by operator (SpaceX, OneWeb, Amazon Kuiper…), by CelesTrak group (constellations, navigation, weather…), by orbit regime (LEO, MEO, GEO, HEO), object type, launch year, recent launches and low-orbit altitude bands. owner, operator or group narrow a list to matching entries (code or name).

輸入參數langgrouplimitowneroperator

perigee_distance

Distance between two objects

Centre-to-centre distance between two objects at a date (km and astronomical units) and the light travel time, with the provenance of both positions. Example: from "earth" to "mars".

輸入參數to必填datefrom必填

perigee_distance_series

Distance over a period

Distances between two objects sampled evenly over a period (for a table or a chart), with the closest and farthest samples. The step limits their precision: use more steps for a precise closest approach.

輸入參數to必填end必填from必填start必填steps

perigee_view

Link or embed a 3D view

Link to Perigee showing an object (optionally at a date, paused or accelerated, followed), and an iframe snippet for a lesson page: the live 3D view without bars or panels. The embedding page can then drive the view and take PNG snapshots with postMessage (protocol perigee:v1, documented in `embedApi`). For a star, star_map opens its 3D map with the Sun instead (every named star at its real distance, the Sun–star distance drawn; compare adds a second star), alone in the iframe.

輸入參數id必填datelangratepanelfollowcomparestar_maptime_bar

perigee_describe_view

Describe a view

Turns a Perigee link or embed URL (from perigee_view or a shared link) into words: a one-sentence alternative text for the image or iframe, and a description for lesson notes (which view, the selected object, where it is and how reliable its position is, the date and speed of time, the frame, the filters and what is hidden). The camera framing is not in the link.

輸入參數url必填langtime_zone

perigee_define

Define a term

Student-level definitions (secondary school) of the terms shown in Perigee: NORAD number, COSPAR id, apogee and perigee, inclination, orbital period, element epoch, ephemeris window, phase… Without a term, lists them all.

輸入參數langterm

perigee_about

Sources, models and accuracy

What every answer rests on: data sources and when they were fetched, the models and their typical accuracy, catalogue sizes, frame, attribution and the educational-use disclaimer.

無需輸入參數。

版本歷史

3
  1. v1.9.5最新Oct 31, 2026
  2. v1.9.3Oct 31, 2026
  3. v1.9.2Oct 30, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分