Ephemeris Mcp

io.github.scottchronicity由 GitHub 帳號 scottchronicity 發布v1.2.0更新於 Oct 24, 2026

Precision astronomical ephemeris and planetary positions via the Swiss Ephemeris.

已驗證STDIO僅桌面位置與生活

概覽

AI 產生的概覽

一個本機 MCP 伺服器，透過 Swiss Ephemeris 為助理提供精確的天文星曆資料，計算行星位置與星盤角度。

可以做什麼
計算行星位置：依指定的 ISO-8601 時間與觀測者座標，回傳太陽、月亮及行星在回歸黃道中的位置，包括星座、度數、順行或逆行、速度與赤緯，以及上升點與中天等星盤角度。
適用情境
適合需要助理針對特定日期、時間與地點計算或討論天文與占星位置（例如星盤角度或行星運動）的情境，不必離開對話。
執行需求
以本機程序透過 stdio 執行，由 MCP 用戶端視需要啟動。可透過 uvx 或 pip 從 PyPI 安裝（Python），或執行已發布的 Docker 映像。未宣告需要帳號、API 金鑰或環境變數。
安裝前請注意
觀測者經緯度預設為密西根州底特律，其他地點須明確傳入座標。結果由 Swiss Ephemeris 計算得出，用於重要用途前應自行核實。

安裝

在 SourceWeft 中

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

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Ephemeris MCP 🌌

[PyPI version] [CI] [License: AGPL v3]

mcp-name: io.github.scottchronicity/ephemeris-mcp

Precision Astronomical Ephemeris for AI Agents.

Ephemeris MCP is a Model Context Protocol (MCP) server that provides AI agents with precision planetary positions using the Swiss Ephemeris.

To use this in Claude Desktop, add this to your claude_desktop_config.json:

json
"mcpServers": {  "ephemeris": {    "command": "uvx",    "args": ["ephemeris-mcp"]  }}

Quick Start

Install via PyPI (Recommended)

bash
# Install with uvx (recommended - fast & isolated, no local install needed)uvx ephemeris-mcp
# Or install globally with pippip install ephemeris-mcppython -m ephemeris_mcp

Register with MCP Clients

Add to your MCP client configuration (client will start server on-demand):

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

json
{  "mcpServers": {    "ephemeris-mcp": {      "command": "uvx",      "args": ["ephemeris-mcp"]    }  }}

VS Code/Cursor/Windsurf (Cline MCP settings):

json
{  "mcpServers": {    "ephemeris-mcp": {      "command": "uvx",      "args": ["ephemeris-mcp"]    }  }}

The client starts the server process automatically, communicates over stdin/stdout, then terminates it when done.

Alternative: Docker

If you prefer container isolation:

bash
# Pull latest imagedocker pull ghcr.io/scottchronicity/ephemeris-mcp:latest
# Test itdocker run --rm -i ghcr.io/scottchronicity/ephemeris-mcp:latest

Configure MCP client with Docker:

json
{  "mcpServers": {    "ephemeris-mcp": {      "command": "docker",      "args": ["run", "--rm", "-i", "ghcr.io/scottchronicity/ephemeris-mcp:latest"]    }  }}

Local Development

bash
# Clone and installgit clone https://github.com/scottchronicity/ephemeris-mcp.gitcd ephemeris-mcpuv sync
# Run testsmake test
# Run locallyuv run ephemeris-mcp
# Test the engine directlymake validate-happycase

Available Tools

get_planetary_positions

Returns precise Tropical Zodiac positions for all planets, Sun, Moon, and chart angles.

Parameters:

  • iso_time (string): ISO-8601 timestamp (e.g., "2025-12-16T15:28:00Z")
  • latitude (float): Observer latitude (default: 42.3314 - Detroit, MI)
  • longitude (float): Observer longitude (default: -83.0458 - Detroit, MI)

Returns:

  • bodies: Sun, Moon, planets with sign, degrees, motion (direct/retrograde), speed, declination
  • houses: Ascendant (ASC) and Midheaven (MC) with sign and degrees

Architecture

See docs/adr/ for architectural decisions:

  • ADR 001: Geocentric Tropical Ecliptic coordinates specification
  • ADR 002: Semantic versioning with Conventional Commits
  • ADR 003: CI/CD pipeline architecture

License

AGPLv3

來源：README.md，提交 2f9055c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分