MicroStation V8i MCP Server

Cầu nối chuyên nghiệp theo chuẩn Model Context Protocol (MCP) giữa các Trợ lý AI (Google Antigravity, Anthropic Claude, Cursor, v.v.) và phần mềm thiết kế kỹ thuật Bentley MicroStation V8i (SELECTseries).

🌟 Tính Năng Chính

• Hệ thống 62 công cụ CAD chuyên sâu: Bao phủ từ dựng hình 2D/3D, đo đạc kích thước, chỉnh sửa đối tượng, điều khiển khung nhìn, quản lý file/model/reference đến xử lý dữ liệu hàng loạt.

• Kiến trúc phân tầng chuẩn Enterprise (Clean Architecture): Phân chia rõ ràng giữa core/ (giao tiếp COM), server/ (factory & lifecycle), tools/, resources/, prompts/ và transports/.

• Hỗ trợ đầy đủ bộ ba MCP:

  • Tools (62 công cụ): 10 nhóm tính năng đồ họa, đo đạc và điều khiển.

  • Resources: Cung cấp thông tin trực tiếp về bản vẽ (ms://drawing/info), danh sách level (ms://drawing/levels), trạng thái active (ms://drawing/settings).

  • Prompts: Khuôn mẫu hướng dẫn quy trình vẽ kỹ thuật (cad_drawing_workflow) và kiểm toán bản vẽ (element_inspection).

• Đa kênh truyền tải (Transports): Hỗ trợ cả stdio (cho Antigravity / Claude Desktop) và sse (Server-Sent Events qua HTTP).

• An toàn luồng: Quản lý CoInitialize / COM Apartment trên từng luồng worker tự động.

• Logging an toàn: Toàn bộ log được định tuyến ra sys.stderr, bảo toàn 100% định dạng JSON-RPC trên kênh stdout.

Related MCP server: multiCAD-mcp

📊 Bảng Danh Mục 10 Nhóm Công Cụ (62 Tools)

📁 Cấu Trúc Thư Mục

microstation-mcp/
├── README.md                   # Tài liệu tổng quan & hướng dẫn cài đặt
├── AGENTS.md                   # Cẩm nang chỉ dẫn cho AI Agent
├── pyproject.toml              # Metadata dự án chuẩn PEP 621
├── requirements.txt            # Thư viện phụ thuộc
├── server.py                   # Shim tương thích ngược
│
├── docs/                       # Tài liệu thiết kế nội bộ
│   ├── architecture.md         # Kiến trúc chi tiết và luồng dữ liệu
│   ├── features.md             # Danh mục toàn bộ 59 Tools, Resources, Prompts
│   └── instructions.md         # Chỉ dẫn hệ thống gửi cho LLM
│
└── src/
    ├── main.py                 # Entry point chính (hỗ trợ --transport stdio|sse)
    ├── core/                   # Cầu nối COM với MicroStation V8i
    ├── server/                 # McpServer factory, logging, context
    ├── tools/                  # 10 module công cụ CAD (59 tools)
    ├── resources/              # Dynamic Resources
    ├── prompts/                # CAD Prompt templates
    └── transports/             # Kênh truyền tải stdio và sse

🚀 Cài Đặt & Cấu Hình

1. Cài đặt thư viện phụ thuộc

pip install -r requirements.txt

2. Cấu hình MCP Client (Antigravity / Claude Desktop)

{
  "mcpServers": {
    "microstation-v8i": {
      "command": "python",
      "args": [
        "-X",
        "utf8",
        "{path}\\microstation-mcp\\src\\main.py"
      ]
    }
  }
}

3. Chạy độc lập qua giao thức SSE (Tùy chọn)

python src/main.py --transport sse --host 127.0.0.1 --port 8000