Swiss Ephemeris MCP Server

A Model Context Protocol (MCP) server that provides astronomical calculations using the Swiss Ephemeris library. Calculate planetary positions, houses, chart points, and asteroids for any date and location.

Features

• Planetary Positions: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto
• Lunar Nodes: True and Mean Node calculations
• Asteroids: Chiron, Ceres, Pallas, Juno, Vesta, Lilith
• Houses: 12-house system using Placidus
• Chart Points: Ascendant, Midheaven, IC, Descendant
• Additional Points: South Node, Part of Fortune

Installation

Prerequisites for Local Development

For local use with Claude Desktop, you need to install the Swiss Ephemeris swetest command:

# Install swetest (required for Claude Desktop usage)
git clone https://github.com/aloistr/swisseph.git /tmp/swisseph && \
    cd /tmp/swisseph && \
    make && \
    cp swetest /usr/local/bin/ && \
    rm -rf /tmp/swisseph

Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "swissEphemeris": {
      "command": "npx",
      "args": ["github:dm0lz/swiss-ephemeris-mcp-server"]
    }
  }
}

Manual Installation

git clone https://github.com/dm0lz/swiss-ephemeris-mcp-server.git
cd swiss-ephemeris-mcp-server
npm install
npm start

Usage

The server provides four main tools:

calculate_planetary_positions

Calculate astronomical data for a specific date, time, and location.

Parameters:

• datetime (string): ISO8601 format, e.g., “1985-04-12T23:20:50Z”
• latitude (number): Latitude in decimal degrees (-90 to 90)
• longitude (number): Longitude in decimal degrees (-180 to 180)

Returns:

• planets: Positions of all planets and celestial bodies
• houses: 12 astrological houses
• chart_points: Ascendant, Midheaven, IC, Descendant
• additional_points: South Node, Part of Fortune

calculate_transits

Calculate birth chart positions and current transits for comparison.

Parameters:

• birth_datetime (string): Birth datetime in ISO8601 format
• latitude (number): Birth latitude in decimal degrees
• longitude (number): Birth longitude in decimal degrees

Returns:

• natal_chart: Complete birth chart data
• current_transits: Current planetary positions
• calculation_time: Timestamp of transit calculation

calculate_solar_revolution

Calculate solar return chart for a specific year (when Sun returns to natal position).

Parameters:

• birth_datetime (string): Birth datetime in ISO8601 format
• birth_latitude (number): Birth latitude in decimal degrees
• birth_longitude (number): Birth longitude in decimal degrees
• return_year (number): Year for solar return calculation (e.g., 2024)
• return_latitude (number, optional): Solar return location latitude
• return_longitude (number, optional): Solar return location longitude

Returns: