# Perigee MCP server

> Provides positions, distances, mission facts, and 3D views of objects orbiting the Earth, Moon, Mars, and Sun for educational purposes.

- Repository: https://github.com/dlamarre-dev/Perigee
- Page: https://hostedmcp.org/servers/dlamarre-dev/perigee
- Transport: stdio, remote
- Stars: 4
- License: MIT
- Latest version: 1.10.1

## Install

### Claude Code

```sh
claude mcp add perigee -- npx -y perigee-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "perigee": {
      "command": "npx",
      "args": [
        "-y",
        "perigee-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "perigee": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "perigee-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"perigee","type":"stdio","command":"npx","args":["-y","perigee-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "perigee": {
      "command": "npx",
      "args": [
        "-y",
        "perigee-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add perigee -- npx -y perigee-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.perigee]
command = "npx"
args = ["-y", "perigee-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user perigee npx -- -y perigee-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "perigee": {
      "command": "npx",
      "args": [
        "-y",
        "perigee-mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `PERIGEE_MCP_CACHE` | no | no | Directory for the on-disk cache (default: OS user cache directory) |
| `PERIGEE_SITE` | no | no | Base URL of the Perigee site to query (default: https://perigee.info/) |

## Tools (19)

- `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`
- `perigee_stats`
- `perigee_distance`
- `perigee_distance_series`
- `perigee_view`
- `perigee_describe_view`
- `perigee_define`
- `perigee_about`

## FAQ

### Is Perigee suitable for navigation or collision avoidance?

No, it is intended for educational use only and should not be used for navigation, collision avoidance, or conjunction assessment.

### How can I use Perigee with Claude Desktop?

You can add it to your claude_desktop_config.json using the npx command: "npx", "-y", "perigee-mcp".

### Does the server contact external data sources like CelesTrak directly?

No, the server uses cached datasets downloaded from Perigee and does not contact CelesTrak or Horizons directly.