Skip to main content
Glama
mcp-astrology

mcp-astrology

by molpass

mcp-astrology

출생 정보를 받아 서양 점성술 네이탈 차트(행성별 별자리·하우스, ASC·MC 텍스트 + 차트 PNG)를 반환하는 MCP 서버. "내 네이탈 차트 그려줘"라고 하면 차트 휠 이미지를 돌려준다.

구조·네이밍·PNG·설치 규약은 STANDARD.md를 따른다. mcp-qr skeleton 복제본.


계산 / 렌더

  • 계산: celestine — Swiss Ephemeris / JPL Horizons 대조 검증된 천체력.

  • 렌더: @astrodraw/astrochart(SVG) → jsdom으로 헤드리스 구동 → sharp로 PNG 변환.

  • 결정론적: 같은 입력 → 같은 차트.


Related MCP server: Astrology MCP Server

도구

get_natal_chart

파라미터

타입

필수

설명

birthDate

string YYYY-MM-DD

✅

생년월일

birthTime

string HH:MM

✅

출생시각 (24시간)

latitude

number

✅

위도 (북위 +, 남위 −)

longitude

number

✅

경도 (동경 +, 서경 −)

timezone

number | string

✅

숫자 오프셋(9, -4) 또는 IANA 존("Asia/Seoul")

IANA 존을 주면 해당 출생 시각의 DST를 반영해 오프셋을 산출한다.

출력 (둘 다 반환):

  1. 구조화 텍스트 — 행성별 별자리·도수·하우스(역행 R 표시), ASC·MC

  2. 네이탈 차트 PNG (1080×1080)

예제 출력: examples/astrology_example.png (1990-05-15 12:00 · 서울 · Asia/Seoul).


설치

git clone https://github.com/molpass/mcp-astrology.git
cd mcp-astrology
npm install && npm run build

예제 차트를 직접 생성해 보려면:

npm run example   # examples/astrology_example.png 재생성

MCP 등록 (서버명 astrology)

{
  "mcpServers": {
    "astrology": {
      "command": "node",
      "args": ["/abs/path/mcp-astrology/dist/index.js"]
    }
  }
}

/abs/path는 클론한 실제 절대경로로 바꾼다. Windows 예: "args": ["C:/Users/<you>/mcp-astrology/dist/index.js"]


스킬

페어링 스킬: skill/astrology.skill.md — 위·경도·시간대가 빠지면 사용자에게 질의하도록 안내한다.

About / 제작

Hermes Agent용 MCP — molpass의 바이브 코딩(vibe coding) 프로젝트.

  • 아이디어·방향: molpass (이정훈) · https://zeolinex.com

  • 기획: Claude (Chat)

  • 개발: Claude Code

자가 호스팅 Hermes Agent에 도구로 붙여 쓰는 MCP 서버입니다.

같은 모음:

License

MIT

Available Tools

1 tool
get_natal_chartGet Natal ChartA

출생 정보(날짜·시각·위경도·시간대)를 받아 서양 점성술 네이탈 차트를 계산한다. 행성별 별자리·하우스와 ASC·MC 텍스트, 그리고 네이탈 차트 PNG를 반환한다.

Inputs: birthDate (required), birthTime (required), latitude (required), longitude (required), +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so no ambiguity. The description clearly defines its purpose.

    Naming Consistency5/5

    With a single tool, naming is inherently consistent.

    Tool Count3/5

    One tool for an astrology server feels thin; users typically expect multiple tools for different astrology functions.

    Completeness2/5

    Only natal chart calculation is available; missing common astrology features like transits, synastry, or progressions.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables astrological chart generation including natal charts, synastry, transits, composite charts, and planetary returns using the Kerykeion library. Supports multiple output formats (text, SVG, PNG) and customizable themes, house systems, and languages.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Calculates astrological birth charts including planetary positions, house placements, and aspects based on birth date, time, and location.
      2,495 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Calculates astrological natal charts with high precision using Swiss Ephemeris, supporting multiple house systems and location inputs.
      2
      28 npm
      5
      AGPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables users to calculate structured astrological birth charts from date, time, gender, and location inputs, returning raw chart data for natural-language interpretation by ChatGPT.
      MIT