numerology

numerology

Calculates Pythagorean numerology core numbers (Life Path, Expression, Soul Urge, etc.) from name and birth date, returning structured text and a summary card PNG.

Category
Visit Server

README

mcp-numerology

이름과 생년월일을 받아 수비학 핵심 수(라이프패스·표현수·소울어지·성격수·생일수·성숙수)와 마스터/카르마 넘버를 계산하는 MCP 서버. 구조화 텍스트 + 요약 카드 PNG를 반환한다.

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


계산 방식 (결정론적, 외부 의존 0)

표준 피타고라스(Pythagorean) 방식으로 직접 구현했다(같은 입력 → 같은 출력).

발주서가 지정한 numerology-npm은 npm에 존재하지 않고(404), 대체 패키지들도 요구 수를 깔끔히 못 채워, PM 결정에 따라 자체 구현으로 진행했다. 의존성 0, 전 과정 수기 검증 가능.

  • 글자값: A=1…I=9 반복. Y, W는 항상 자음으로 처리(컨텍스트 변형 미적용).
  • 모음: A, E, I, O, U.
  • 마스터 넘버(11/22/33): 환원하지 않고 보존.
  • 카르마 부채(13/14/16/19): 환원 마지막 두 자리 단계가 해당 값이면 표기.
  • Life Path: 월·일·연을 각각 환원 → 합산 → 환원.
산출
라이프패스 (Life Path) 생년월일
표현수 (Expression) 이름 전체 글자합
소울어지 (Soul Urge) 이름의 모음합
성격수 (Personality) 이름의 자음합
생일수 (Birthday) 태어난 날(日)
성숙수 (Maturity) 라이프패스 + 표현수

도구

get_numerology

파라미터 타입 필수 설명
fullName string 이름. 라틴 알파벳 기준 — 한글 이름은 로마자로 표기 (예: 홍길동 → Hong Gildong)
birthDate string YYYY-MM-DD 생년월일

한글 이름 처리: 이름 기반 수(표현수/소울어지/성격수)는 라틴 알파벳 글자값으로 계산한다. 입력에 라틴 알파벳이 없으면(예: 순수 한글) 도구가 로마자 표기를 요청하는 에러를 반환한다.

출력 (둘 다 반환):

  1. 구조화 텍스트 — 각 수 + 마스터/카르마 여부 + 의미 키워드 + Life Path 환원 과정
  2. 요약 카드 PNG (1080×640, 핵심 수 6개)

예제 출력: examples/numerology_example.png (John Lennon · 1940-10-09 → Life Path 6).


설치

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

예제 카드를 직접 생성해 보려면:

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

폰트: 한글 라벨을 위해 한글 가능 폰트가 필요하다. Windows는 Malgun Gothic 기본 탑재라 추가 설치 불필요. Linux는 Nanum/Noto CJK 권장.


MCP 등록 (서버명 numerology)

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

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


스킬

페어링 스킬: skill/numerology.skill.md.

License

MIT

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured