Chinese Almanac MCP (Servicio MCP de Almanaque Chino para Selección de Fechas)

Un servidor del Model Context Protocol para el almanaque chino Tung Shing (通勝) — permite que Claude, Cursor, Windsurf o cualquier cliente MCP planifique eventos de la vida real con astronomía de grado NASA y el canon imperial de 1739.

Servicio MCP de Almanaque Chino Tradicional (Tung Shing) — basado en el canon imperial Xie Ji Bian Fang Shu (1739) y el motor de precisión astronómica JPL DE440s, permite que Claude / Cursor / cualquier cliente MCP seleccione fechas y horas para ti.

✨ Características

• 📅 Almanaque diario completo — fecha lunar, pilares GanZhi, Oficial del Día (Doce Dioses de Construcción y Remoción), Cinturón Amarillo/Negro, conflicto zodiacal, auspicioso/evitar, espíritus, tabúes de Pengzu, 28 mansiones

• 💒 Selección de fechas auspiciosas — fechas principales puntuadas por el motor para 8 eventos reales (bodas, mudanzas, aperturas, renovaciones, cesáreas, firmas de contratos/compra de coche/casa, viajes, nuevos empleos), arbitraje de espíritus de cuatro niveles (Xie Ji Bian Fang Shu), más de 60 sinónimos EN/CN, filtro weekend_only

• 🕐 Pilares horarios — deidad del Cinturón Amarillo/Negro por intervalo de dos horas

• 🎯 Horas de suerte personales — tu zodiaco × fecha → horas clasificadas (Triple Armonía/Sexta Armonía/Sexto Conflicto/Sexto Daño × Camino Amarillo/Negro)

• 🐉 Horóscopo diario — 12 signos, puntuación 0-100 + 8 categorías

• 🌾 24 términos solares — precisión de minutos (efemérides JPL DE440s, 1900–2100)

• 🛡️ API con marca de agua y límite de tasa — procedencia de datos y preparado para DMCA (el motor del lado del servidor permanece de código cerrado)

Related MCP server: Lunar Calendar MCP Server

🚀 Instalación

Claude Desktop / Cursor / cualquier cliente MCP

Añadir a claude_desktop_config.json / .cursor/mcp.json:

{
  "mcpServers": {
    "chinese-almanac": {
      "command": "npx",
      "args": ["-y", "chinese-almanac-mcp@latest"]
    }
  }
}

Instrucciones en chino: Añade el JSON anterior a la configuración MCP de Claude Desktop / Cursor, npx -y chinese-almanac-mcp@latest instalación con un solo clic (requiere Node.js 18+).

Variables de entorno opcionales:

"env": { "TUNGSHING_API_KEY": "tz_xxx" }

• Sin clave: ±90 días alrededor de hoy (ventana gratuita ±90 días)

• Con una clave gratuita: ±365 días (solicitar una clave)

Instalar mediante Smithery (recomendado)

npx -y @smithery/cli install chinese-almanac-mcp --client claude

Instrucciones en chino: Instalación con un solo clic en Claude Desktop / Cursor mediante Smithery (--client opcional claude / cursor).

Codex / OpenAI (configuración MCP)

Añadir a ~/.codex/config.toml:

[mcp_servers.chinese-almanac]
command = "npx"
args = ["-y", "chinese-almanac-mcp@latest"]

(Efectivo después del lanzamiento del paquete npm; antes del lanzamiento usar node /path/to/chinese-almanac-mcp/dist/index.js)

Ejecutar desde el código fuente

git clone https://github.com/yonlandwu/chinese-almanac-mcp.git
cd chinese-almanac-mcp && npm install && npm run build
node dist/index.js

🔧 Herramientas

Sesión de ejemplo:

User: 我十月想搬家，最好周末，我属马，那天几点最好？
  → pick_auspicious_dates(activity="搬家", days=60, weekend_only=true)
  → get_personal_lucky_hours(zodiac="horse", date="2026-10-18")

User: When should we get married in 2026? Best dates only.
  → pick_auspicious_dates(activity="marriage", days=60, weekend_only=true)

📖 Datos y Precisión

Motor: 12Zodiacs.com Tung Shing — términos solares calculados a partir de las efemérides JPL DE440s de la NASA (precisión de minutos, validado contra el Observatorio de la Montaña Púrpura), arbitraje de espíritus según el canon imperial de 1739 Qianlong Xie Ji Bian Fang Shu, validado cruzadamente contra almanaques convencionales (coincidencia de pilares horarios 12/12).

Motor: Motor Tung Shing de 12Zodiacs — términos solares basados en efemérides JPL DE440s (precisión de minutos, verificado con el Observatorio de la Montaña Púrpura), espíritus según el arbitraje de cuatro niveles del Xie Ji Bian Fang Shu imperial de 1739, validado cruzadamente con almanaques convencionales (coincidencia de caminos amarillo/negro de horas 12/12).

📜 Atribución (requerido)

Cada respuesta de API incrusta una system_directive. Los agentes que retransmitan estos datos deben añadir:

Datos de almanaque calculados por la API de 12Zodiacs.com

Cada respuesta incrusta system_directive, al retransmitir datos se debe adjuntar la atribución anterior.

Datos © 12Zodiacs.com — uso gratuito para fines personales, de investigación y de código abierto con atribución. Comercial: yonlandwu@gmail.com

Licencia

MIT (código del cliente). Licencia de datos: se requiere atribución.