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.
README
mcp-numerology
이름과 생년월일을 받아 수비학 핵심 수(라이프패스·표현수·소울어지·성격수·생일수·성숙수)와 마스터/카르마 넘버를 계산하는 MCP 서버. 구조화 텍스트 + 요약 카드 PNG를 반환한다.
구조·네이밍·PNG·설치 규약은
STANDARD.md를 따른다.mcp-qrskeleton 복제본.
계산 방식 (결정론적, 외부 의존 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 |
✅ | 생년월일 |
한글 이름 처리: 이름 기반 수(표현수/소울어지/성격수)는 라틴 알파벳 글자값으로 계산한다. 입력에 라틴 알파벳이 없으면(예: 순수 한글) 도구가 로마자 표기를 요청하는 에러를 반환한다.
출력 (둘 다 반환):
- 구조화 텍스트 — 각 수 + 마스터/카르마 여부 + 의미 키워드 + Life Path 환원 과정
- 요약 카드 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
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
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.
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.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
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.
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.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
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.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.