GEN NX结构工程API服务

Claude / GPT / Cursor
    │  MCP Protocol (stdio)
    ▼
Main FastMCP ("gennx")
    ├── modeling    (9 endpoints  · nodes, elements, materials, sections …)
    ├── boundary    (8 endpoints  · constraints, springs, rigid links …)
    ├── loads       (15 endpoints · load cases, nodal/beam loads, LCOM 6 sub-types …)
    ├── analysis    (6 endpoints  · eigenvalue, buckling, pushover …)
    └── project     (9 endpoints  · open/save/close, analysis run, view capture …)
              │  tool call
              ▼
         GennxApiClient (httpx async)  ──▶  GEN NX REST API (localhost:8080)

    + resource  gennx://feature/{slug}  ──▶  SchemaRegistry (in-memory, no GEN NX call)

schemas/raw/*.json
    → SchemaRegistry (load & merge 66 schema files → 47 endpoints)
    → ToolFactory (generate closure per method)
    → FunctionTool (name, description, JSON Schema params, annotations)
    → FastMCP.add_tool()

gennx://feature/{slug}      # slug = endpoint with "/" and "-" → "_", lowercased
                            # e.g. gennx://feature/db_node, gennx://feature/doc_new

pip install -e .

cp .env.example .env

# GEN NX REST API base URL (required)
GENNX_API_BASE_URL=https://moa-engineers.midasit.com:443/gen

# MAPI key for GEN NX authentication (required for MIDAS cloud API)
GENNX_MAPI_KEY=your-mapi-key-here

claude mcp add gennx \
  -e GENNX_API_BASE_URL=https://moa-engineers.midasit.com:443/gen \
  -e GENNX_MAPI_KEY=your-mapi-key-here \
  -- mcp-gennx

{
  "mcpServers": {
    "gennx": {
      "command": "mcp-gennx",
      "args": [],
      "env": {
        "GENNX_API_BASE_URL": "https://moa-engineers.midasit.com:443/gen",
        "GENNX_MAPI_KEY": "your-mapi-key-here"
      }
    }
  }
}

You: Create a simple beam model with 3 nodes at (0,0,0), (5,0,0), (10,0,0)
AI:  [calls post_db_node with Assign: {"1": {"X":0,"Y":0,"Z":0}, "2": {"X":5,...}, ...}]
     Created 3 nodes successfully.

You: Connect them with beam elements
AI:  [calls post_db_elem with Assign: {"1": {"TYPE":"BEAM","MATL":1,"SECT":1,"NODE":[1,2]}, ...}]
     Created 2 beam elements.

TOOLSETS=default                  # 87 tools — core endpoints only
TOOLSETS=all                      # 161 tools — all endpoints
TOOLSETS=default,loads_advanced   # default + advanced load types
TOOLSETS=modeling_core            # only core modeling tools (20 tools)
READ_ONLY=true                   # expose only GET tools

mcp-gennx/
├── pyproject.toml
├── .env.example
└── src/mcp_gennx/
    ├── __init__.py              # Entry point (main)
    ├── server.py                # Server assembly & toolset filtering
    ├── config.py                # GennxSettings (pydantic-settings)
    ├── routing.py               # Endpoint routing + toolset presets loaded from data/*.json
    ├── data/
    │   ├── endpoint_subserver_map.json   # endpoint → sub-server/toolset/tier (single source of truth)
    │   └── toolset_definitions.json      # default/all toolset presets
    ├── client/
    │   └── gennx_client.py      # Async HTTP client for GEN NX API
    ├── schemas/
    │   ├── registry.py          # SchemaRegistry — loads & merges JSON schemas (incl. description/usage)
    │   ├── models.py            # ApiSchema (+ description, feature_name, menu_path, usage), ToolDef
    │   └── raw/                 # 66 JSON schema files
    ├── servers/
    │   ├── _common.py           # register_routed_tools() — map-driven tool registration
    │   ├── modeling.py          # Nodes, elements, materials, sections
    │   ├── boundary.py          # Constraints, springs, rigid links
    │   ├── loads.py             # Load cases, forces, combinations (LCOM), response spectrum
    │   ├── analysis.py          # Eigenvalue, buckling, nonlinear
    │   ├── project.py           # File ops, analysis run, view capture
    │   └── feature_docs.py      # gennx://feature/{slug} resource (lazy GUI/usage docs)
    ├── tools/
    │   └── factory.py           # ToolFactory — dynamic tool generation
    └── utils/
        └── descriptions.py      # Composes tool descriptions from schema fields

pip install -e ".[dev]"
pytest