ming-metaphysics-mcp

Cinco motores de metafísica china como herramientas MCP para Claude Desktop y cualquier cliente compatible con MCP.

vs bazi-mcp de Cantian

Herramientas

Requisito del motor

Este paquete es un contenedor (wrapper) MCP. No contiene lógica de cálculo de metafísica; reenvía las llamadas de herramientas a un punto final del motor Ming a través de HTTP. Para usarlo, apunte MING_API_URL a un motor en ejecución.

Dos formas de obtener un motor:

1. Punto final alojado (preferido, cuando esté disponible). Se anunciará un punto final público de Ming; una vez disponible, configure MING_API_URL para apuntar a él y listo.

2. Autoalojamiento. El motor Ming en sí es actualmente una implementación de referencia de código cerrado. Si tiene acceso al código base de Ming, ejecute uvicorn api.main:app --port 8000 y apunte este MCP a localhost:8000.

Sin un motor accesible, el servidor MCP se inicia y enumera las herramientas, pero las llamadas a las herramientas devuelven un error HTTP.

Instalación

Paso 1 — Asegúrese de que el motor sea accesible

Consulte "Requisito del motor" arriba.

Paso 2 — Instale el servidor MCP

npm install -g ming-metaphysics-mcp

Paso 3 — Añada a claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ming": {
      "command": "ming-metaphysics-mcp",
      "args": [],
      "env": {
        "MING_API_URL": "http://localhost:8000"
      }
    }
  }
}

Reinicie Claude Desktop. Las herramientas de Ming aparecerán en la lista de herramientas.

Verificación

En Claude Desktop:

Using the ming_bazi_analyze tool, analyze the chart for someone born 1990-03-15, male, in Singapore.

Debería obtener una lectura completa de BaZi. Si la herramienta da error, verifique que el motor de Python se esté ejecutando en el puerto 8000.

Brechas en el punto final

Las siguientes capacidades requieren una expansión de FastAPI antes de que funcionen completamente según lo especificado. Cada una está marcada con una nota en la respuesta de la herramienta — no hay fallos silenciosos.

Para implementar estrellas voladoras específicas por año o soporte para forecast_year, añada esos parámetros a /consult en api/main.py y actualice los manejadores de herramientas correspondientes aquí.

Desarrollo

git clone <this-repo>
cd ming-metaphysics-mcp
npm install
npm run build          # compile TypeScript → dist/
npm test               # smoke tests (no engine required)

# With engine running at localhost:8000:
npx ts-node scripts/benchmark.ts --tool all --iterations 5

Variables de entorno

Objetivos de latencia

Si alguna herramienta supera los 5s de forma consistente, verifique el cuello de botella del motor y considere añadir timeout: 10000 a la configuración de MCP.

Autenticación

Ninguna a nivel de contenedor — este servidor es de código abierto y gratuito (licencia MIT). La autenticación, si existe, es aplicada por cualquier punto final al que apunte MING_API_URL.

Para una lectura completa de cinco motores

Una consulta guiada de cinco motores (BaZi + ZWDS + QMDJ + Feng Shui + I Ching sintetizados por el Maestro Chen) está disponible a través del bot de Telegram de Ming. El enlace se publicará una vez que el bot esté en versión beta pública.

Privacidad

Este contenedor MCP en sí no recopila datos. Reenvía los argumentos de su herramienta (fecha de nacimiento, hora, género, texto de la pregunta) a cualquier MING_API_URL que haya configurado. Si apunta a un punto final alojado, ese punto final recibe los datos — lea su política de privacidad. Si se autoaloja, nada sale de su red.

Los datos de nacimiento son sensibles. Si está configurando esto para usuarios finales, sea explícito sobre qué punto final recibe sus entradas.

Estado del proyecto

Este paquete está en la versión 1.0.0. La superficie del protocolo MCP (6 herramientas, esquemas JSON, formas de respuesta) es estable. El motor Ming subyacente evoluciona más rápido — los cambios numéricos menores en las respuestas de las herramientas son normales.

Las contribuciones son bienvenidas — consulte CONTRIBUTING.md.

Licencia

MIT — consulte LICENSE.