GetBirthChart MCP

Servidor MCP oficial para cálculos estructurados de carta natal, posiciones planetarias, Big Three, signo lunar, signo ascendente, aspectos y sinastría a través de GetBirthChart.

GitHubPrueba este MCPPatrocinado

Documentación

@getbirthchart/mcp

Servidor MCP oficial para cálculos astrológicos de GetBirthChart. Proporciona a clientes de IA compatibles con MCP acceso a cálculos estructurados a través de la API pública de GetBirthChart; no contiene ni reimplementa el motor astrológico.

Requisitos

Node.js 20 o superior
Una clave de API de desarrollador de GetBirthChart

Crea una clave en getbirthchart.com/developers. Mantenla privada y no confirmes configuraciones de host MCP que contengan la clave real.

Inicio rápido

El paquete se ejecuta sobre MCP stdio y puede lanzarse con npx:

{
  "mcpServers": {
    "getbirthchart": {
      "command": "npx",
      "args": ["-y", "@getbirthchart/mcp"],
      "env": {
        "GETBIRTHCHART_API_KEY": "gbc_live_your_key_here"
      }
    }
  }
}

Esta es la configuración estándar basada en comandos para hosts que admiten servidores MCP stdio. Usa la documentación actual de tu cliente para la ubicación exacta del archivo de configuración o de la interfaz; este repositorio ha sido probado a nivel de protocolo con el cliente oficial de MCP TypeScript, no con clientes específicos de proveedores.

Variables de entorno

Variable	Obligatoria	Descripción
`GETBIRTHCHART_API_KEY`	Sí	Clave de API de desarrollador del lado del servidor.
`GETBIRTHCHART_API_BASE_URL`	No	Anulación de la URL base de la API HTTPS para desarrollo/pruebas. HTTP solo se acepta para localhost.

La clave se lee al inicio, nunca se acepta como argumento de herramienta y nunca se escribe en stdout, registros, recursos o resultados de herramientas.

Herramientas disponibles

Todas las herramientas son de solo lectura y devuelven hechos de cálculo estructurados. Las entradas usan campos estrictos: date, opcionales time y place, obligatorios latitude, longitude y timezone, además de unknown_time opcional.

Herramienta	Propósito	¿Hora exacta obligatoria?	Comportamiento con hora desconocida
`calculate_birth_chart`	Hechos completos de la carta natal	No	Omite Ascendente y casas; conserva la incertidumbre.
`get_planet_positions`	Posiciones planetarias	No	Conserva la incertidumbre de la carta.
`get_big_three`	Sol, Luna y Ascendente	No	No adivina el Ascendente.
`get_moon_sign`	Signo lunar y certeza	No	Devuelve ambigüedad cuando el backend no puede establecer un signo.
`get_rising_sign`	Ascendente	Sí	Devuelve `birth_time_required`.
`calculate_aspects`	Aspectos natales	No	Devuelve solo hechos propiedad del backend.
`calculate_synastry`	Relaciones entre cartas para `person_a` y `person_b`	Por persona	Conserva los límites de hora desconocida de cada persona.

La API pública actual no geocodifica place; proporciona latitud, longitud y una zona horaria IANA incluso cuando se incluye una etiqueta de lugar. El servidor MCP nunca asume mediodía o medianoche y nunca adivina casas, el Ascendente o un signo lunar ambiguo.

Ejemplo de entrada:

{
  "date": "1990-01-15",
  "time": "12:00",
  "place": "New York, NY",
  "latitude": 40.7128,
  "longitude": -74.006,
  "timezone": "America/New_York"
}

Hora desconocida:

{
  "date": "1990-01-15",
  "unknown_time": true,
  "latitude": 40.7128,
  "longitude": -74.006,
  "timezone": "America/New_York"
}

Recursos

getbirthchart://methodology — convenciones de cálculo y límites de hora desconocida.
getbirthchart://data-sources — efemérides, zona horaria y procedencia de la entrada de ubicación.
getbirthchart://engine-info — metadatos del proveedor y de la API pública.

Referencias web autorizadas: Metodología y Fuentes de datos.

Errores

Los fallos de herramientas usan datos estructurados de error con un code seguro legible por máquina, mensaje, retryable y retry_after opcional. Los códigos comunes incluyen validation_error, authentication_required, birth_time_required, location_not_found, ambiguous_location, rate_limit_exceeded, timeout y internal_error.

Privacidad y seguridad

Los datos de nacimiento se pasan solo a la API pública configurada para el cálculo solicitado. Este paquete no persiste, almacena en caché ni registra entradas de nacimiento, y no tiene análisis ni telemetría. La anulación opcional de la URL base cambia el límite de confianza; no envíes una clave de producción a un host no confiable.

Reporta problemas de seguridad de forma privada mediante el proceso en SECURITY.md. No incluyas claves de API en informes de errores.

Desarrollo

npm install
npm run lint
npm run typecheck
npm test
npm run build

Las pruebas usan clientes simulados y no llaman a la API de producción. Para ejecutar el servidor compilado localmente, establece GETBIRTHCHART_API_KEY y ejecuta node dist/cli.js; el tráfico normal del protocolo permanece en stdout, mientras que los fallos de inicio se escriben en stderr.

Enlaces

Metadatos del registro MCP

Los metadatos del registro se preparan en server.json con el nombre de servidor io.github.getbirthchart-com/getbirthchart-mcp. Publica primero el paquete npm, luego autentícate con la herramienta oficial mcp-publisher y publica los metadatos. El envío al registro no forma parte intencionalmente del proceso de compilación ni del flujo de CI del paquete.