@decasoul/mcp-server
@decasoul/mcp-server
DecaSoul MCP server es un servidor de Model Context Protocol que permite a los asistentes de IA (Claude, Cursor y cualquier cliente MCP) calcular una carta china de los Cuatro Pilares del Destino — Bazi (八字) — y leer el arquetipo de Diez Almas (十神) de una persona directamente a partir de su fecha y hora de nacimiento.
Es la integración MCP oficial de DecaSoul — el MBTI Oriental, un sistema chino de autoconocimiento de 4.000 años de antigüedad que lee la personalidad y los patrones de vida a partir de los Cuatro Pilares de tu hora de nacimiento, en lugar de basarse en respuestas autoinformadas.
⚠️ Este servidor es un marco de autoconocimiento / personalidad, no un motor de predicción. Es para la reflexión y la educación, no para consejos médicos, psicológicos o financieros.
Qué hace
Cuando un asistente de IA se conecta a este servidor, obtiene una única herramienta — analyze_bazi — que convierte una hora de nacimiento en una carta legible:
Cuatro Pilares (八字 / SiZhu): los pilares de año, mes, día y hora, cada uno con un Tronco Celeste (天干) + una Rama Terrestre (地支).
Maestro del Día (日主): el tronco del día — el punto de referencia de toda la carta.
Diez Alma Dominante (十神 / ShiShen): el arquetipo principal de la carta, asignado a su nombre en chino e inglés.
El cálculo se delega en la biblioteca de código abierto @decasoul/bazi-calculator, por lo que la lógica es transparente y verificable.
Related MCP server: Chinese Fortune Analysis System (BaZi)
Instalación
npm install @decasoul/mcp-serverEjecútalo como servidor MCP
npx decasoul-mcpConfigura un cliente
Añádelo a la configuración de tu cliente MCP. Por ejemplo, en Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"decasoul-bazi": {
"command": "npx",
"args": ["-y", "@decasoul/mcp-server"]
}
}
}Para Cursor u otros clientes MCP, apúntalos al mismo comando y el servidor anunciará automáticamente su herramienta analyze_bazi.
Referencia de herramientas
analyze_bazi
Calcula los Cuatro Pilares y la Diez Alma dominante a partir de una hora de nacimiento.
Parámetro | Tipo | Obligatorio | Descripción |
| number | sí | Año de nacimiento gregoriano, p. ej. |
| number | sí | Mes de nacimiento |
| number | sí | Día de nacimiento |
| number | sí | Hora de nacimiento |
| string | no |
|
Devuelve un resumen de texto con los cuatro pilares, el Maestro del Día y la Diez Alma dominante tanto en chino como en inglés.
¿Qué son las Diez Almas (十神)?
Las Diez Almas son diez arquetipos relacionales derivados de cómo se relaciona cada otro elemento de una carta Bazi con el Maestro del Día. Son el motor detrás del "MBTI Oriental":
Key | 中文 | English |
Bijian | 比肩 | The Standing Beside |
Jiecai | 劫财 | Forged by Fire |
Shishen | 食神 | Feeding the World |
Shangguan | 伤官 | Truth Before Comfort |
Zhengcai | 正财 | Building Steadily |
Piancai | 偏财 | Seeing Openings |
Zhengguan | 正官 | Order as Safety |
Qisha | 七杀 | Breaking Ground |
Zhengyin | 正印 | Seeing Deeper |
Pianyin | 偏印 | Wandering Inward |
Bazi frente al zodiaco chino
Una pregunta habitual es si Bazi (八字) es lo mismo que el zodiaco chino (生肖). No lo es:
Dimensión | Zodiaco chino (生肖) | Bazi (八字) |
Entrada | Solo el año de nacimiento | Año / mes / día / hora de nacimiento |
Resolución | 12 signos animales | Cuatro Pilares → Diez Almas |
Profundidad | Un rasgo por año | Arquetipo individual + puntos ciegos |
Origen | ~2.000 años, dinastía Han | ~4.000 años, linaje del I Ching |
El zodiaco es una sola nota; Bazi es la partitura completa — por eso este servidor calcula los Cuatro Pilares completos en lugar de solo el signo del año.
¿Por qué 4.000 años?
El sistema desciende del I Ching (易经) y de la teoría del yin-yang y los Cinco Elementos (五行). Tomó forma en la dinastía Han, fue refinado por Li Xuzhong (唐代李虚中) y Xu Ziping (宋代徐子平, autor de Yuan Hai Zi Ping 渊海子平), y floreció durante las dinastías Ming y Qing, donde una vez sirvió a la corte imperial y a la aristocracia para emparejamientos y selección de fechas. Ese linaje es el fundamento cultural detrás del "MBTI Oriental".
Licencia
MIT — DecaSoul Research (Shenshuge Information Consulting). Consulta LICENSE.
This server cannot be deployed
Maintenance
Related MCP Connectors
BaZi four pillars, Chinese zodiac, lunisolar calendar and almanac days for AI agents.
Generate BaZi charts from birth details. Explore Four Pillars, solar terms, and Luck Pillars for d…
Cast a BaZi (Four Pillars) chart with true solar time, plus a reflective personality sketch.
BaZi (Chinese Four Pillars) chart calculator. Structured chart data only, no predictions.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI tools to perform Chinese fortune-telling analysis including Ziwei Doushu (Purple Star Astrology) and Bazi (Four Pillars) chart generation, fortune reading, and element analysis. Supports multiple calendar systems and output formats for comprehensive divination services.75 npm22 PyPI6MIT
- AlicenseNot gradedqualityDmaintenanceEnables traditional Chinese fortune-telling through BaZi (Four Pillars) analysis, including solar/lunar date conversion, Five Element balance calculations, Ten Gods deduction, and destiny interpretation for metaphysics applications.10 npmMIT
- AlicenseAqualityDmaintenanceProvides tools for Bazi (Chinese astrology) chart calculation and analysis, enabling LLMs to generate accurate birth charts, determine patterns, and answer follow-up questions based on actual calculations rather than model knowledge.2MIT
- AlicenseAqualityCmaintenanceEnables AI agents to perform Chinese metaphysics calculations including BaZi charts, Tong Shu indicators, solar terms, and more, using a verified engine with 740+ tests.88MIT