Skip to main content
Glama
shenshuge

@decasoul/mcp-server

by shenshuge

@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-server

Ejecútalo como servidor MCP

npx decasoul-mcp

Configura 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

year

number

sí

Año de nacimiento gregoriano, p. ej. 1990

month

number

sí

Mes de nacimiento 1–12

day

number

sí

Día de nacimiento 1–31

hour

number

sí

Hora de nacimiento 0–23 (0 = 00:00–00:59)

gender

string

no

"male" o "female"

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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Enables 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.
    7
    5 npm
    22 PyPI
    6
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables 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 npm
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Provides 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.
    2
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to perform Chinese metaphysics calculations including BaZi charts, Tong Shu indicators, solar terms, and more, using a verified engine with 740+ tests.
    8
    8
    MIT