Skip to main content

bridge-qt-mcp

MCP server for QtBridge (桥通) — bridge finite element analysis software.

This MCP server exposes 348 tools that allow AI assistants (Claude Desktop, Claude Code, etc.) to directly control the QtBridge software for bridge modeling, analysis, and design verification.

Features

  • 348 tools auto-generated from the qtmodel Python API
    • mdb_* (234 tools) — Modeling: nodes, elements, materials, sections, loads, tendons, construction stages
    • odb_* (89 tools) — Results: reactions, deformations, stresses, visualization
    • cdb_* (25 tools) — Design checks: concrete, steel box, steel truss, anti-overturn
  • Zero configuration — all tools are auto-discovered from the qtmodel package
  • Full parameter schemas with types, defaults, and descriptions from docstrings

Prerequisites

  • QtBridge (桥通) software must be running (provides HTTP API at localhost:55125)
  • Python >= 3.10

Installation

pip install bridge-qt-mcp

Or install from source:

git clone https://github.com/Inface0443/pyqt.git
cd pyqt
pip install -e .

Configuration

Claude Desktop

Add to your Claude Desktop config file:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "bridge-qt": {
      "command": "bridge-qt-mcp"
    }
  }
}

Claude Code

claude mcp add bridge-qt -- bridge-qt-mcp

Cursor / Other MCP Clients

Use stdio transport with command bridge-qt-mcp.

Usage Examples

Once connected, you can ask Claude to interact with QtBridge directly:

Modeling:

"Create 10 nodes at coordinates (0,0,0) to (9,0,0) with 1m spacing, then connect them with beam elements using C50 concrete."

Results:

"Get the support reactions at nodes 500, 502, 488 for construction stage 9, and export them to an Excel file."

Visualization:

"Plot the bending moment diagram for the operational stage with load case '成桥(合计)'."

Design Checks:

"Run the concrete structure verification for the default structure group."

Tool Naming Convention

Tools follow the pattern {module}_{method_name}:

Prefix Module Description
mdb_ Model Database Pre-processing: create/modify model
odb_ Output Database Post-processing: query results
cdb_ Check Database Design verification

Common Tools

Tool Description
mdb_add_nodes Add nodes by coordinates
mdb_add_element Add a single element
mdb_add_material Define material properties
mdb_add_section Define cross-section
mdb_add_construction_stage Define construction stage
mdb_do_solve Run analysis
odb_get_reaction Get support reactions
odb_get_deformation Get node displacements
odb_get_element_force Get element internal forces
odb_get_element_stress Get element stresses
odb_plot_beam_element_force Plot beam force diagram
cdb_solve_concrete_check Run concrete verification

Development

# Clone the repo
git clone https://github.com/Inface0443/pyqt.git
cd pyqt

# Install in development mode
pip install -e .

# Run the server directly
bridge-qt-mcp
# or
python -m qtmodel.mcp_server

qtmodel Python API

This package also provides the qtmodel Python library for scripting QtBridge directly:

from qtmodel import mdb, odb, cdb

# Add nodes
mdb.add_nodes(node_data=[[1, 0, 0, 0], [2, 1, 0, 0], [3, 2, 0, 0]])

# Add beam elements
mdb.add_element(index=1, ele_type=1, node_ids=[1, 2], mat_id=1, sec_id=1)
mdb.add_element(index=2, ele_type=1, node_ids=[2, 3], mat_id=1, sec_id=1)

# Run analysis
mdb.do_solve()

# Get results
import json
reactions = json.loads(odb.get_reaction(ids=[1, 3], stage_id=1))
print(reactions)

See the full API documentation for details.

License

MIT

Metadata

Release files for bridge-qt-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bridge-qt-mcp 0.1.0
File Size Uploaded Provenance Actions
bridge_qt_mcp-0.1.0.tar.gz 401.5 kB Without provenance Details for bridge_qt_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for bridge-qt-mcp 0.1.0
File Interpreter ABI Platform Actions
bridge_qt_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for bridge_qt_mcp-0.1.0-py3-none-any.whl

Total release size: 491.1 kB

Release files / bridge_qt_mcp-0.1.0.tar.gz

Download URL bridge_qt_mcp-0.1.0.tar.gz
Size 401.5 kB
Tags Source
SHA-256 checksum
How to use checksums
db50b9eb5cdd2339d6439b724555645fc03f66a83f55fef0d6ab9768bb2ba75f
BLAKE2b-256 checksum
How to use checksums
28827b1f724f351f294536d1458e58ef5eee58735eb568d0f721f253db759a0f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / bridge_qt_mcp-0.1.0-py3-none-any.whl

Download URL bridge_qt_mcp-0.1.0-py3-none-any.whl
Size 89.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3ade1b18516d6b528b8470efb3d6857686e072c765c905375734f317e4486330
BLAKE2b-256 checksum
How to use checksums
977289c4a069c3acd0286dfd4f8cdc034992d0e7c8e4d1dbd3a8cd1b9a72b24c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Security for bridge-qt-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page