TianJi Astrology

io.github.feifeizhao25-ship-it由 GitHub 帳號 feifeizhao25-ship-it 發布v1.0.0更新於 Nov 1, 2026

Ephemeris-grade natal charts, current transits, zodiac sign profiles. No API key.

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

概覽

AI 產生的概覽

遠端 MCP 伺服器，為助理計算星曆級出生星盤、目前行運與星座基本資料。

可以做什麼
  • 依出生日期、時間與地點計算完整出生星盤，含行星、宮位與相位
  • 取得今日行星位置，用於行運分析與擇時
  • 查詢某一星座的基本資料
  • 用星盤 JSON 驗證解讀說法是否有依據
適用情境
當助理需要確定性的占星計算而非生成的星座運勢文字時適用，例如產生出生星盤、查看目前天象，或在發布解讀前核對說法是否有星盤依據。
執行需求
遠端 streamable HTTP 端點；參考類工具無需 API 金鑰或帳號。若以城市與國家取代經緯度，地點會線上地理編碼。也可用 Docker 或 Python（fastmcp、kerykeion）自行架設。
安裝前請注意
出生資料（日期、時間、地點）會傳送到託管伺服器；README 稱僅用於計算、不儲存也不記錄，但這只是營運方說法。依城市查詢會進行線上地理編碼，地點資訊會離開伺服器。輸出為確定性計算結果，並非建議。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "tianji-astrology": {
      "type": "http",
      "url": "https://mcp.tianji-astrology.com/mcp"
    }
  }
}

README

TianJi Astrology MCP Server

Computation-first astrology tools for AI agents. Real ephemeris-grade planetary positions, houses, and aspects — not generic sun-sign content.

Built by TianJi Astrology on top of kerykeion 6.x (libephemeris engine). Transport: streamable HTTP (MCP spec).

Live endpoint: https://mcp.tianji-astrology.com/mcp

Why this server

Most astrology MCP servers wrap horoscope text. TianJi computes the actual chart:

  • Swiss-ephemeris-grade planetary longitudes, retrogrades, and house cusps (via kerykeion/libephemeris)
  • Full 12-house placement with cusp houses resolved per planet
  • Major aspects (conjunction, sextile, square, trine, opposition) computed with standard orbs
  • Deterministic output an agent can reason over — no LLM-generated "readings" in the loop

Tools

compute_natal_chart

Compute a natal (birth) chart from date, time, and place.

Parameters: name, year, month, day, hour (default 12), minute (default 0), city, nation, lng, lat, tz_str.

Returns JSON: positions for Sun through Pluto (sign, degree, house, retrograde), Ascendant/MC, house cusps, and the aspect list with exact orbits.

get_current_transits

Today's sky: current planetary positions for all ten bodies, with retrograde flags. No parameters.

get_sign_profile

Reference facts for a zodiac sign: element, modality, ruling planet (traditional + modern), date range. Parameter: sign (e.g. "Scorpio").

Usage

Remote (hosted)

The server runs publicly at https://mcp.tianji-astrology.com/mcp (streamable HTTP transport). Point any MCP client that supports remote servers at that URL — no API key required for the reference tools.

Claude Desktop / Claude Code (claude mcp add):

bash
claude mcp add --transport http tianji https://mcp.tianji-astrology.com/mcp

Cursor / other clients: add a server entry with type http (or streamable-http) and the URL above.

Self-host

bash
docker build -t tj-mcp .docker run -p 8033:8033 tj-mcp

Or bare Python:

bash
pip install fastmcp kerykeionpython server.py

Data & privacy

All computation is local to the server. Birth data is used only to compute the chart and is never stored or logged.

License

MIT — see LICENSE.

TianJi Astrology: personalized Western astrology, computed. https://tianji-astrology.com

來源：README.md，提交 d57694b

工具

4

compute_natal_chart

Compute Natal Chart

Compute a full natal (birth) chart: 10 planets (sign/degree/house/retrograde), 12 Placidus house cusps, and inter-planetary aspects (major aspects, classic orbs). Pass lng/lat/tz_str (e.g. -74.01, 40.71, 'America/New_York') for exact offline computation; otherwise city+nation are geocoded online.

輸入參數day必填latlngcityhourname必填year必填month必填minutenationtz_str

get_current_transits

Get Current Transits

Today's planetary positions (UTC now at Greenwich) — the current sky, for transit analysis, daily overviews, and timing work.

無需輸入參數。

get_sign_profile

Get Sign Profile

Reference card for a zodiac sign: element, modality, ruling planet.

輸入參數sign必填

validate_interpretation

Validate Interpretation

Anti-hallucination confirmation gate (kosma-style): verify interpretation claims are grounded in the chart before publishing them. chart_json = exact JSON from compute_natal_chart or get_current_transits. claims = JSON array: [{"text": "...", "factors": [ {"type": "aspect", "a": "Sun", "b": "Moon"}, # aspect exists in chart {"type": "planet_house", "a": "Sun", "b": 5}, # planet is in that house {"type": "planet_sign", "a": "Sun", "b": "Leo"}, # planet is in that sign {"type": "house_sign", "a": 5, "b": "Leo"}]}] # house cusp is in that sign A claim is supported only if >= 2 of its factors independently exist in the chart. Returns per-claim verdicts; gate = "blocked" if any claim is unsupported — rewrite the claim against verified factors or drop it.

輸入參數claims必填chart_json必填

版本歷史

1
  1. v1.0.0最新Nov 1, 2026

評分

已滿足適用檢查項的 100%

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

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