🌉 Qiao-MCP

English · 简体中文

フルライフサイクル橋梁構造解析 — モデリング、施工段階、規格照査 橋梁全過程構造解析 MCP サーバー — モデリング、施工段階、規格照査

Qiao-MCP は Model Context Protocol (MCP) サーバーであり、AI アシスタントが橋梁構造解析ソフトウェアと対話できるようにします。橋梁モデルの作成、荷重の適用、構造解析の実行、結果の確認のためのツールを提供します。

機能

🔧 ツール（132 ツール、グループ化）

ツールはワークフロー領域ごとに整理されています。グループごとのハイライト：

ツールの応答は構造化コンテンツ（{status, ...}）に正規化され、画像ツールは MCP 画像コンテンツを直接返すことができます。ツールの失敗は型付き MCP エラーを使用し、読み取り専用、破壊的、およびオープンワールド操作には MCP ツール注釈が付与されます。サーバー指示にはツールグループの概要全体が含まれます。ゲートウェイ経由でカバーされていないバックエンドメソッドを呼び出す前に、list_qtmodel_api を使用してください。

📦 リソース（7 リソース）

💬 プロンプト（4 ワークフロー）

Related MCP server: ETABS MCP Server

アーキテクチャ

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

プロバイダーパターンにより、132 のツールが単一のバックエンドから切り離されています。BRIDGE_PROVIDER で選択します。各プロバイダーは独自のソフトウェア固有のルールを宣言するため、LLM はプロンプトを変更せずに適応します。現在サポートしているもの：

• QTModel (qtmodel、デフォルト) — QiaoTong (橋通) 橋梁解析ソフトウェア（ユーザーマニュアル）

バックエンドを追加するには、BridgeProvider を実装して 1 行登録するだけです。ツールレイヤーの変更は不要です。バックエンド選択 を参照してください。

クイックスタート

前提条件

• Python >= 3.11

• uv パッケージマネージャー

• qtmodel 2.6.3（uv sync でインストール）

• バックエンドモデル、解析、または可視化操作を呼び出す際に実行中の QiaoTong ソフトウェア 2.6.3

MCP サーバーは QiaoTong なしで起動できます。check_qiaotong_connection を使用して、接続済みサーバー、バージョンの不一致、およびソフトウェアが実行されていない状態を区別します。

インストールと実行

# Install dependencies
uv sync

# Run the server
uv run qiao-mcp

Claude Desktop での設定

claude_desktop_config.json に追加：

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

Cursor での設定

.cursor/mcp.json に追加：

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

Reasonix（UI）での設定

設定 → MCP & Tools を開き、新しい MCP サーバーを追加：

• 名前: qiao-mcp

• トランスポート: stdio（デフォルトのまま）

• コマンド: uv --directory /path/to/qiao-mcp run qiao-mcp

  • /path/to/qiao-mcp を実際のプロジェクトパスに置き換えてください

  • Windows: バックスラッシュ D:\path\to\qiao-mcp を使用

  • macOS/Linux: フォワードスラッシュ /path/to/qiao-mcp を使用

• 環境変数（オプション）: UV_PYTHON=3.11

追加 をクリックして保存。

Cherry Studio（UI）での設定

設定 → 拡張 → MCP Servers を開き、新しいサーバーを追加：

• 名称: qiao-mcp

• 説明: オプションの説明

• タイプ: 標準入力 / 出力 (stdio)

• コマンド: uv

• パッケージマネージャー: デフォルト を選択

• 引数:

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

  （各行が 1 つの引数で、--directory プレフィックスは不要）

  • /path/to/qiao-mcp を実際のプロジェクトパスに置き換えてください

保存 をクリックして保存。

MCP Inspector でのテスト

npx @modelcontextprotocol/inspector uv run qiao-mcp

LAN デバッグプロキシ

クロスマシンデバッグ用に、scripts/qiaotong_lan_proxy.py は LAN 向けポートを同じマシンの QiaoTong API に転送します。プロキシには 45125 を使用し、選択した QiaoTong プロセスを 127.0.0.1:55125 に転送します：

python scripts/qiaotong_lan_proxy.py

次に、クライアントマシンを次のように指定します：

from qtmodel import mdb

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

プロキシは転送された各リクエストとレスポンスを出力します。複数の QiaoTong プロセスが実行されている場合、この固定プロキシ用に 1 つのプロセスを 55125 に維持するか、別々のプロセス用に別々のプロキシインスタンスとポートを使用します。

SSH トンネルは、API ポートを LAN に公開しない代替手段です：

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

トンネル実行中は、クライアントマシンで http://127.0.0.1:45125/pythonForQt/ を使用します。

開発

# 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

テストスイートはオフラインで実行できるように設計されています — QiaoTong ソフトウェアは必要ありません。プロバイダー/ツールの呼び出しは、インストールされた qtmodel API シグネチャ（契約テスト）に対して検証され、インプロセスのフェイクバックエンドに対してディスパッチされます。

バックエンド: QTModel（橋通）

この MCP サーバーは qtmodel Python API をラップしており、以下へのアクセスを提供します：

• mdb — モデルデータベース：橋梁モデルの構築と修正

• odb — 出力データベース：解析結果のクエリと可視化

• cdb — 照査データベース：構造検証と規格照査

バージョン管理

Qiao-MCP は qtmodel とは独立してバージョン管理されます。プロジェクトは（バグ修正、新しいツール、ドキュメントなど）バックエンドのリリースを待たずに独自に反復し、バックエンドのリリースによってここでのバージョンが強制的に上がることはありません。バックエンド要件は、依存関係の制約として適切な場所に表現されます。

互換性

QiaoTong ソフトウェアの API バージョンとインストールされた qtmodel は正確に一致する必要があります。qtmodel 2.6+ は正確なバージョンハンドシェイクを実行し、一致しない場合は接続を拒否します。check_qiaotong_connection を実行して両方のバージョンを確認し、異なる場合の対処方法を確認してください。

0.x は API がまだ変更される可能性があることを示しており、リリース品質に関するものではありません。新しい qtmodel マイナーラインに移行する場合は、依存関係の上限を引き上げ、上記の表に行を追加してください。

ライセンス

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

Apache License, Version 2.0 に基づいてライセンスされています。LICENSE を参照してください。追加の帰属表示は NOTICE にあります。