Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Chinese Almanac MCP

de yonlandwuversión 1.0.2i★ 0iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.yonlandwu/chinese-almanac-mcp

Cómo instalar

What it does

Chinese almanac (黄历) MCP: date selection, daily almanac, solar terms, zodiac horoscopes.

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Astrología y fechas propicias

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad7/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso7/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Chinese Almanac MCP. Sigue https://mcp.popnx.com/i/yonlandwu-chinese-almanac-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Chinese Almanac MCP para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "chinese-almanac": { "command": "npx", "args": [ "-y", "chinese-almanac-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Chinese Almanac MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "chinese-almanac": {
          "command": "npx",
          "args": [
            "-y",
            "chinese-almanac-mcp"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa Chinese Almanac MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Chinese Almanac MCP o muestra una herramienta de Chinese Almanac MCP en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TUNGSHING_API_KEY Clave de API gratuita y opcional de 12Zodiacs.com para el rango de ±365 días (el uso anónimo permite ±90 días).
    Ver original en inglésOptional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days).

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Chinese Almanac MCP

Chinese Almanac MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Chinese Almanac MCP

  • Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Astrología y fechas propicias que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Chinese Almanac MCP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user chinese-almanac -- npx -y chinese-almanac-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Chinese Almanac MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user chinese-almanac -- npx -y chinese-almanac-mcp
  4. Escribe /mcp en Claude Code

    Deberías ver Chinese Almanac MCP en la lista como conectado

  5. Pruébalo

    Usa Chinese Almanac MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Chinese Almanac MCP o muestra una herramienta de Chinese Almanac MCP en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TUNGSHING_API_KEY Clave de API gratuita y opcional de 12Zodiacs.com para el rango de ±365 días (el uso anónimo permite ±90 días).
    Ver original en inglésOptional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days).

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Chinese Almanac MCP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "chinese-almanac": { "command": "npx", "args": [ "-y", "chinese-almanac-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Chinese Almanac MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa Chinese Almanac MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Chinese Almanac MCP o muestra una herramienta de Chinese Almanac MCP en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TUNGSHING_API_KEY Clave de API gratuita y opcional de 12Zodiacs.com para el rango de ±365 días (el uso anónimo permite ±90 días).
    Ver original en inglésOptional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days).

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Chinese Almanac MCP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "chinese-almanac": { "type": "stdio", "command": "npx", "args": [ "-y", "chinese-almanac-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Chinese Almanac MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa Chinese Almanac MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Chinese Almanac MCP o muestra una herramienta de Chinese Almanac MCP en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TUNGSHING_API_KEY Clave de API gratuita y opcional de 12Zodiacs.com para el rango de ±365 días (el uso anónimo permite ±90 días).
    Ver original en inglésOptional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days).

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Chinese Almanac MCP💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user chinese-almanac -- npx -y chinese-almanac-mcp

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "chinese-almanac": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "chinese-almanac-mcp"
      ]
    }
  }
}

Valores que debes completar

  • TUNGSHING_API_KEY secreto env
    Clave de API gratuita y opcional de 12Zodiacs.com para el rango de ±365 días (el uso anónimo permite ±90 días).
    Ver original en inglésOptional free API key from 12Zodiacs.com for ±365-day range (anonymous allows ±90 days).

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
62/sem
Conexión
Se ejecuta en tu computadora
Última versióni
1.0.2
Publicado en el registroi
26 ago 2026
Último cambio de códigoi
4 oct 2026
Creador
yonlandwu
Paquetes
npm: chinese-almanac-mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub yonlandwu, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 2 meses

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para chinese-almanac-mcp@1.0.2

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 16 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/yonlandwu-chinese-almanac-mcp.svg)](https://mcp.popnx.com/en/servers/yonlandwu-chinese-almanac-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Astrología y fechas propiciasi

  • Más estrellas que el 0% de los otros 130 servidores de esta categoría
  • Publicado en el registro más recientemente que el 13% de los otros 130 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 130 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Chinese Almanac MCP?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 2 meses, y la última versión (1.0.2) llegó al registro hace 3 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Open Ephemeris, Totally Tarot Calculators, Moon Dasha Vedic Astrology, Supastro, NatalChart.AI Astrology

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Open Ephemeris

Astrology app for ChatGPT and Claude: real charts from NASA JPL DE440, not AI guesses.

de openephemerisInicial★ 5Actualizado hace 4 días

Se ejecuta en la nube✓ del servicio · openephemeris.com

Supastro

Vedic astrology calculations: birth charts, dashas, transits, yogas, compatibility and panchang

de supastro.comInicialActualizado ayer

Se ejecuta en la nube✓ del servicio · supastro.com
Comparado con otros parecidos
Este
Chinese Almanac MCP
Open EphemerisTotally Tarot CalculatorsMoon Dasha Vedic AstrologySupastroNatalChart.AI Astrology
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas3/34/42/32/32/32/3
LicenciaMITMIT––––
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Chinese Almanac MCP (中国黄历择日 MCP 服务)

A Model Context Protocol server for the Chinese Tung Shing (通勝) almanac — let Claude, Cursor, Windsurf, or any MCP client plan real-life events with NASA-grade astronomy and the 1739 imperial canon.

中国传统黄历(通胜)MCP 服务 — 基于协纪辨方书(1739 钦定)与 JPL DE440s 天文级精度引擎,让 Claude / Cursor / 任意 MCP 客户端为你择日择时。

✨ Features 功能

  • 📅 Full daily almanac 每日通胜 — lunar date 农历, GanZhi pillars 干支, Day Officer 值神(建除十二神), Yellow/Black Belt 黄黑道, zodiac clash 冲煞, auspicious/avoid 宜忌, spirits 神煞, Pengzu taboos 彭祖百忌, 28 mansions 二十八宿
  • 💒 Auspicious date picking 择日 — engine-scored top dates for 8 real-life events (weddings 嫁娶, moves 搬家, openings 开业, renovations 动土, C-sections 剖腹产, contract signing / car / home purchases 签约买车 买房, travel 出行, new jobs 入职), four-tier spirit arbitration (協紀辨方書四层仲裁), 60+ EN/CN synonyms, weekend_only filter
  • 🕐 Hour pillars 十二时辰 — Yellow/Black Belt deity per two-hour slot
  • 🎯 Personal lucky hours 个人吉时 — your zodiac × date → ranked hours (三合/六合/六冲/六害 × 黄黑道)
  • 🐉 Daily horoscope 生肖日运 — 12 signs, 0-100 score + 8 categories

v1.1 — Transparent auspicious picking 择日增强

pick_auspicious_dates now supports patron_birth (福主生日):

  • Patron zodiac match — days clashing (六冲) or harming (六害) the patron's zodiac are vetoed; 三合/六合 days get +15 with bilingual reasons.
  • Fixed inauspicious days hard-veto — 杨公忌 / 三娘煞 (weddings) / 十恶大败 / 四离四绝 (computed from minute-precision solar terms).
  • Transparent split — engine_score (0-5 four-tier arbitration) and local_adjustment are reported separately, never double-counted.
  • `pick_dates_deep` — day-by-day scan for burial 安葬 & ancestor worship 祭祀 (no engine shortlist exists for these), capped at 31-day windows.
  • All scoring logic is ported from and cross-validated against the tung-shing-almanac-skill Python engine — 249 test vectors, 100% match.
  • 🌾 24 solar terms 二十四节气 — minute precision (JPL DE440s ephemeris, 1900–2100)
  • 🛡️ Watermarked, rate-limited API — data provenance & DMCA-ready (server-side engine stays closed-source)

🚀 Install 安装

Claude Desktop / Cursor / any MCP client

Add to claude_desktop_config.json / .cursor/mcp.json:

{

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

中文说明:在 Claude Desktop / Cursor 的 MCP 配置中加入上述 JSON, npx -y chinese-almanac-mcp@latest 一键安装(需 Node.js 18+)。

Optional env:

"env": { "TUNGSHING_API_KEY": "tz_xxx" }
Install via Smithery (recommended 推荐)
npx -y @smithery/cli install chinese-almanac-mcp --client claude

中文说明:通过 Smithery 一键安装到 Claude Desktop / Cursor(--client 可选 claude / cursor)。

Codex / OpenAI (MCP config)

Add to ~/.codex/config.toml:

[mcp_servers.chinese-almanac]

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

*(npm 包发布后生效;发布前用 node /path/to/chinese-almanac-mcp/dist/index.js)*

Run from source 源码运行
git clone https://github.com/yonlandwu/chinese-almanac-mcp.git

cd chinese-almanac-mcp && npm install && npm run build node dist/index.js

🔧 Tools 工具

ToolDescription 说明
get_daily_almanacFull almanac for a date 某日完整黄历(农历/干支/值神/黄黑道/冲煞/宜忌/神煞)
get_hour_pillars12 two-hour pillars 十二时辰黄黑道吉凶
get_solar_terms24 solar terms, minute precision 某年二十四节气(分钟级)
pick_auspicious_datesTop dates for an event 择日(8 活动 + 同义词 + weekend_only)
get_daily_horoscopeZodiac daily luck 生肖日运(12 生肖)
get_personal_lucky_hoursRanked hours for your zodiac 个人吉时(三合六合×黄黑道)
list_activitiesAll events + synonyms 活动与同义词清单

Example session 示例:

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)

📖 Data & Accuracy 数据与精度

Engine: 12Zodiacs.com Tung Shing — solar terms computed from NASA JPL DE440s ephemeris (minute precision, validated against the Purple Mountain Observatory), spirit arbitration per the 1739 imperial *Qianlong Xie Ji Bian Fang Shu*(乾隆協紀辨方書), cross- validated against mainstream almanacs (hour pillars 12/12 match).

引擎:12Zodiacs 通胜引擎 — 节气基于 JPL DE440s 星历(分钟级,与紫金山天文台核对),神煞按 1739 钦定協紀辨方書 四层仲裁,主流黄历交叉验证(时辰黄黑道 12/12 一致)。

📜 Attribution 署名(required 必须)

Every API response embeds a system_directive. Agents relaying this data must append:

*Almanac data computed by 12Zodiacs.com API*

每个响应内嵌 system_directive,转发数据时必须附带上述署名。

Data © 12Zodiacs.com — free for personal, research, and open-source use with attribution. Commercial: yonlandwu@gmail.com

Learn more

License

MIT (client code). Data license: attribution required.