🌉 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 и регистрацию одной строки — без изменений на уровне инструментов. См. Выбор бэкенда.

Быстрый старт

Предварительные требования

• 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)

Откройте Settings → MCP & Tools, затем добавьте новый MCP-сервер:

• Name: qiao-mcp

• Transport: stdio (оставьте по умолчанию)

• Command: 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

• Environment (опционально): UV_PYTHON=3.11

Нажмите Add, чтобы сохранить.

Настройка в Cherry Studio (UI)

Откройте 设置 → 扩展 → MCP Servers, затем добавьте новый сервер:

• 名称 (Name): qiao-mcp

• 描述 (Description): Описание (опционально)

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

• 命令 (Command): uv

• 包管理器 (Package Manager): Выберите 默认 (По умолчанию)

• 参数 (Args):

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

  (Каждая строка — один аргумент, префикс --directory не требуется)

  • Замените /path/to/qiao-mcp на ваш фактический путь к проекту

Нажмите 保存, чтобы сохранить.

Тестирование с помощью MCP Inspector

npx @modelcontextprotocol/inspector uv run qiao-mcp

Прокси для отладки по LAN

Для отладки на разных машинах scripts/qiaotong_lan_proxy.py перенаправляет порт, доступный по LAN, на API QiaoTong на той же машине. Он использует 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, оставьте один процесс на 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. Вызовы провайдера/инструмента проверяются на соответствие установленным сигнатурам API qtmodel (контрактные тесты) и обрабатываются через встроенный имитированный бэкенд.

Бэкенд: QTModel (桥通)

Этот MCP-сервер оборачивает Python API qtmodel, который предоставляет доступ к:

• mdb — База данных модели: создание и изменение моделей мостов

• odb — База данных результатов: запрос результатов анализа и визуализация

• cdb — База данных проверки: структурная верификация и проверка по нормам

Версионирование

Qiao-MCP версионируется независимо от qtmodel — проект развивается самостоятельно (исправления ошибок, новые инструменты, документация) без ожидания выхода бэкенда, и выпуск бэкенда не требует изменения версии здесь. Требование к бэкенду выражается там, где это необходимо: в ограничении зависимостей.

Совместимость

Версия API программного обеспечения QiaoTong и установленный 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.