🌉 Qiao-MCP

Englisch · 简体中文

Ganzheitliche Brückenstrukturanalyse – Modellierung, Bauphasen, Normnachweise
MCP-Server für die ganzheitliche Brückenstrukturanalyse – Modellierung, Bauphasen, Normnachweise

Qiao-MCP ist ein Model Context Protocol (MCP)-Server, der KI-Assistenten die Interaktion mit Brückenstrukturanalyse-Software ermöglicht. Es bietet Werkzeuge zum Erstellen von Brückenmodellen, zum Aufbringen von Lasten, zur Durchführung von Strukturanalysen und zur Überprüfung von Ergebnissen.

Funktionen

🔧 Werkzeuge (132 Werkzeuge, gruppiert)

Die Werkzeuge sind nach Arbeitsbereichen organisiert. Highlights pro Gruppe:

Werkzeugantworten werden auf strukturierte Inhalte ({status, ...}) normalisiert, während Bildwerkzeuge MCP-Bildinhalte direkt zurückgeben können. Werkzeugfehler verwenden typisierte MCP-Fehler, und schreibgeschützte, destruktive und offene Weltoperationen tragen MCP-Werkzeugannotationen. Die Serveranweisungen enthalten die vollständige Werkzeuggruppenübersicht; verwenden Sie list_qtmodel_api, bevor Sie eine nicht abgedeckte Backend-Methode über das Gateway aufrufen.

📦 Ressourcen (7 Ressourcen)

💬 Prompts (4 Workflows)

Related MCP server: ETABS MCP Server

Architektur

qiao-mcp/
├── src/qiao_mcp/
│   ├── server.py              # MCP server entry point
│   ├── tools/                 # MCP Tools (envelope-wrapped)
│   ├── resources/             # MCP Resources
│   ├── prompts/               # MCP Prompts
│   └── providers/             # Backend adapters
│       ├── __init__.py        # BridgeProvider abstract base
│       └── qtmodel_provider.py  # QiaoTong adapter
├── tests/                     # Offline unit, integration, and API contract tests
└── reference-docs/            # Review notes and project documentation

Das Provider-Muster hält die 132 Werkzeuge von einem einzelnen Backend entkoppelt. Wählen Sie eines mit BRIDGE_PROVIDER aus; jeder Provider deklariert seine eigenen softwarespezifischen Regeln, sodass sich das LLM ohne Prompt-Änderungen anpasst. Derzeit unterstützt:

• QTModel (qtmodel, Standard) — QiaoTong (桥通) Brückenanalysesoftware (Benutzerhandbuch)

Das Hinzufügen eines Backends bedeutet die Implementierung von BridgeProvider und die Registrierung einer Zeile — keine Werkzeugschicht-Änderungen. Siehe Backend-Auswahl.

Schnellstart

Voraussetzungen

• Python >= 3.11

• uv Paketmanager

• qtmodel 2.6.3 (installiert durch uv sync)

• QiaoTong-Software 2.6.3, die beim Aufrufen von Backend-Modell-, Analyse- oder Visualisierungsoperationen läuft

Der MCP-Server kann ohne QiaoTong gestartet werden. Verwenden Sie check_qiaotong_connection, um zwischen einem verbundenen Server, einem Versionskonflikt und einer nicht laufenden Software zu unterscheiden.

Installieren & Ausführen

# Install dependencies
uv sync

# Run the server
uv run qiao-mcp

Konfigurieren in Claude Desktop

Fügen Sie zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "qiao-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/qiao-mcp", "run", "qiao-mcp"]
    }
  }
}

Konfigurieren in Cursor

Fügen Sie zu .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "qiao-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/qiao-mcp", "run", "qiao-mcp"]
    }
  }
}

Konfigurieren in Reasonix (UI)

Öffnen Sie Einstellungen → MCP & Tools, dann fügen Sie einen neuen MCP-Server hinzu:

• Name: qiao-mcp

• Transport: stdio (Standard beibehalten)

• Befehl: uv --directory /path/to/qiao-mcp run qiao-mcp

  • Ersetzen Sie /path/to/qiao-mcp durch Ihren tatsächlichen Projektpfad

  • Windows: verwenden Sie Backslashes D:\path\to\qiao-mcp

  • macOS/Linux: verwenden Sie Forward-Slashes /path/to/qiao-mcp

• Umgebung (optional): UV_PYTHON=3.11

Klicken Sie auf Hinzufügen, um zu speichern.

Konfigurieren in Cherry Studio (UI)

Öffnen Sie 设置 → 扩展 → MCP Servers, dann fügen Sie einen neuen Server hinzu:

• 名称 (Name): qiao-mcp

• 描述 (Beschreibung): Optionale Beschreibung

• 类型 (Typ): 标准输入 / 输出 (stdio)

• 命令 (Befehl): uv

• 包管理器 (Paketmanager): Wählen Sie 默认 (Standard)

• 参数 (Args):

  /path/to/qiao-mcp
  run
  qiao-mcp

  (Jede Zeile ist ein Argument, kein --directory-Präfix erforderlich)

  • Ersetzen Sie /path/to/qiao-mcp durch Ihren tatsächlichen Projektpfad

Klicken Sie auf 保存, um zu speichern.

Testen mit MCP Inspector

npx @modelcontextprotocol/inspector uv run qiao-mcp

LAN-Debugging-Proxy

Für die maschinenübergreifende Fehlersuche leitet scripts/qiaotong_lan_proxy.py einen LAN-zugänglichen Port an die QiaoTong-API auf derselben Maschine weiter. Es verwendet 45125 für den Proxy und leitet an den ausgewählten QiaoTong-Prozess auf 127.0.0.1:55125 weiter:

python scripts/qiaotong_lan_proxy.py

Dann richten Sie die Client-Maschine auf:

from qtmodel import mdb

mdb.set_url("http://<proxy-machine-LAN-IP>:45125/pythonForQt/")

Der Proxy gibt jede weitergeleitete Anfrage und Antwort aus. Wenn mehrere QiaoTong-Prozesse ausgeführt werden, halten Sie einen Prozess auf 55125 für diesen festen Proxy, oder verwenden Sie separate Proxy-Instanzen und Ports für separate Prozesse.

Ein SSH-Tunnel ist eine Alternative, die den API-Port nicht im LAN freigibt:

ssh -N -L 45125:127.0.0.1:55125 <user>@<qiaotong-machine-LAN-IP>

Verwenden Sie http://127.0.0.1:45125/pythonForQt/ auf der Client-Maschine, während der Tunnel läuft.

Entwicklung

# Install in dev mode (includes ruff, mypy, pytest)
uv sync

# Run directly
uv run python -m qiao_mcp.server

# Quality gate (same checks as CI)
uv run ruff check src/ tests/
uv run mypy src/qiao_mcp/
uv run pytest tests/ -q

Die Testsuite ist für den Offline-Betrieb ausgelegt – sie benötigt die QiaoTong-Software nicht. Provider-/Werkzeugaufrufe werden gegen die installierten qtmodel-API-Signaturen validiert (Vertragstests) und gegen ein prozessinternes Fake-Backend ausgeführt.

Backend: QTModel (桥通)

Dieser MCP-Server kapselt die qtmodel Python-API, die Zugriff bietet auf:

• mdb — Modelldatenbank: Erstellen und Ändern von Brückenmodellen

• odb — Ausgabedatenbank: Abfragen von Analyseergebnissen & Visualisierung

• cdb — Prüfdatenbank: Strukturelle Verifikation & Normnachweise

Versionierung

Qiao-MCP versioniert unabhängig von qtmodel – das Projekt entwickelt sich eigenständig weiter (Fehlerbehebungen, neue Werkzeuge, Dokumentation), ohne auf ein Backend-Release zu warten, und ein Backend-Release erzwingt hier keinen Versionssprung. Die Backend-Anforderung wird dort ausgedrückt, wo sie hingehört: in der Abhängigkeitsbeschränkung.

Kompatibilität

Die API-Version der QiaoTong-Software und das installierte qtmodel müssen exakt übereinstimmen – qtmodel 2.6+ führt einen präzisen Versions-Handshake durch und verweigert andernfalls die Verbindung. Führen Sie check_qiaotong_connection aus, um beide Versionen zu sehen und zu erfahren, was zu tun ist, wenn sie abweichen.

0.x signalisiert, dass sich die API noch ändern kann; es ist keine Aussage über die Release-Qualität. Wenn Sie zu einer neuen qtmodel-Nebenlinie wechseln, erhöhen Sie die Abhängigkeitsgrenze und fügen Sie eine Zeile zur obigen Tabelle hinzu.

Lizenz

Copyright 2026 Sorata (https://github.com/SorataYang)

Lizenziert unter der Apache License, Version 2.0. Siehe LICENSE. Zusätzliche Hinweise zur Namensnennung finden Sie in NOTICE.