ming-metaphysics-mcp

Fünf chinesische Metaphysik-Engines als MCP-Tools für Claude Desktop und jeden MCP-kompatiblen Client.

vs Cantians bazi-mcp

Tools

Engine-Anforderung

Dieses Paket ist ein MCP-Wrapper. Es enthält keine Metaphysik-Berechnungslogik — es leitet Tool-Aufrufe über HTTP an einen Ming-Engine-Endpunkt weiter. Um es zu nutzen, richten Sie MING_API_URL auf eine laufende Engine aus.

Zwei Wege, eine Engine zu erhalten:

1. Gehosteter Endpunkt (bevorzugt, falls verfügbar). Ein öffentlicher Ming-Endpunkt wird angekündigt; sobald verfügbar, konfigurieren Sie MING_API_URL darauf und Sie sind fertig.

2. Selbst-Hosting. Die Ming-Engine selbst ist derzeit eine Closed-Source-Referenzimplementierung. Wenn Sie Zugriff auf die Ming-Codebasis haben, führen Sie uvicorn api.main:app --port 8000 aus und richten Sie dieses MCP auf localhost:8000 aus.

Ohne eine erreichbare Engine startet der MCP-Server und listet Tools auf, aber Tool-Aufrufe geben einen HTTP-Fehler zurück.

Installation

Schritt 1 — Sicherstellen, dass eine Engine erreichbar ist

Siehe "Engine-Anforderung" oben.

Schritt 2 — Installieren des MCP-Servers

npm install -g ming-metaphysics-mcp

Schritt 3 — Hinzufügen zur 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"
      }
    }
  }
}

Starten Sie Claude Desktop neu. Die Ming-Tools erscheinen in der Tool-Liste.

Überprüfung

In Claude Desktop:

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

Sie sollten eine vollständige BaZi-Lesung erhalten. Wenn das Tool einen Fehler meldet, überprüfen Sie, ob die Python-Engine auf Port 8000 läuft.

Endpunkt-Lücken

Die folgenden Funktionen erfordern eine FastAPI-Erweiterung, bevor sie wie spezifiziert vollständig funktionieren. Jede ist mit einem Hinweis in der Tool-Antwort markiert — keine stillen Fehler.

Um jahresspezifische fliegende Sterne oder forecast_year-Unterstützung zu implementieren, fügen Sie diese Parameter zu /consult in api/main.py hinzu und aktualisieren Sie die entsprechenden Tool-Handler hier.

Entwicklung

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

Umgebungsvariablen

Latenzziele

Wenn ein Tool konsistent 5s überschreitet, überprüfen Sie den Engine-Flaschenhals und erwägen Sie, timeout: 10000 zur MCP-Konfiguration hinzuzufügen.

Authentifizierung

Keine auf Wrapper-Ebene — dieser Server ist Open-Source und kostenlos (MIT-Lizenz). Authentifizierung, falls vorhanden, wird von dem Endpunkt erzwungen, auf den MING_API_URL zeigt.

Für eine vollständige Fünf-Engine-Lesung

Eine geführte Fünf-Engine-Beratung (BaZi + ZWDS + QMDJ + Feng Shui + I Ging, synthetisiert von Meister Chen) ist über den Telegram-Bot von Ming verfügbar. Der Link wird veröffentlicht, sobald sich der Bot in der öffentlichen Beta befindet.

Datenschutz

Dieser MCP-Wrapper selbst sammelt keine Daten. Er leitet Ihre Tool-Argumente (Geburtsdatum, Uhrzeit, Geschlecht, Fragetext) an den von Ihnen konfigurierten MING_API_URL weiter. Wenn Sie auf einen gehosteten Endpunkt zeigen, empfängt dieser Endpunkt die Daten — lesen Sie dessen Datenschutzrichtlinie. Wenn Sie selbst hosten, verlässt nichts Ihr Netzwerk.

Geburtsdaten sind sensibel. Wenn Sie dies für Endbenutzer konfigurieren, seien Sie explizit darüber, welcher Endpunkt ihre Eingaben empfängt.

Projektstatus

Dieses Paket befindet sich in Version 1.0.0. Die MCP-Protokolloberfläche (6 Tools, JSON-Schemata, Antwortformen) ist stabil. Die zugrunde liegende Ming-Engine entwickelt sich schneller — geringfügige numerische Änderungen in Tool-Antworten sind normal.

Beiträge sind willkommen — siehe CONTRIBUTING.md.

Lizenz

MIT — siehe LICENSE.