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 分