MCP Gennx

mcp gennx

  

域驱动的MCP服务器，通过模型上下文协议公开GEN NX结构工程REST API。

特性

• 动态工具生成 --工具在启动时从JSON模式文件生成。无代码生成步骤；添加模式文件，注册端点，工具就会出现。
• 域驱动的子服务器 --5个子服务器（建模、边界、负载、分析、项目）按结构工程领域组织工具。
• 工具集筛选 --控制通过环境变量公开哪些工具：87个工具（默认）、159个工具（全部）或仅GET（只读模式）。

建筑

Claude / GPT / Cursor
    │  MCP Protocol (stdio)
    ▼
Main FastMCP ("gennx")
    ├── modeling    (9 endpoints  · nodes, elements, materials, sections …)
    ├── boundary    (8 endpoints  · constraints, springs, rigid links …)
    ├── loads       (14 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 …)
              │
         GennxApiClient (httpx async)
              │
         GEN NX REST API (localhost:8080)

动态工具管道

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

每个端点最多生成4个工具——每个HTTP方法一个：

快速开始

1.安装

pip install -e .

2.配置

复制 .env.example 到 .env 并设置所需的环境变量：

cp .env.example .env

编辑 .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

MAPI密钥：从MIDAS用户门户发布。服务器将其作为 MAPI-Key 对GEN NX REST API的每个请求的HTTP头。仅当目标是不需要身份验证的本地GEN NX实例时，才保留为空。

3.用克劳德代码注册

通过以下方式传递环境变量 -e 标记，以便生成的MCP进程继承它们：

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

或者手动添加到MCP客户端配置中：

{
  "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"
      }
    }
  }
}

4.使用

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                      # 159 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)
    ├── client/
    │   └── gennx_client.py      # Async HTTP client for GEN NX API
    ├── schemas/
    │   ├── registry.py          # SchemaRegistry — loads & merges JSON schemas
    │   ├── models.py            # ApiSchema, ToolDef data models
    │   └── raw/                 # 65 JSON schema files
    ├── servers/
    │   ├── modeling.py          # Nodes, elements, materials, sections
    │   ├── boundary.py          # Constraints, springs, rigid links
    │   ├── loads.py             # Load cases, forces, combinations (LCOM)
    │   ├── analysis.py          # Eigenvalue, buckling, nonlinear
    │   └── project.py           # File ops, analysis run, view capture
    ├── tools/
    │   └── factory.py           # ToolFactory — dynamic tool generation
    └── utils/
        └── descriptions.py      # Auto-generated tool descriptions

支持的API

第1层——核心（默认工具集）

第2级——高级

项目操作（手动注册）

发展

运行测试

pip install -e ".[dev]"
pytest

添加新的API

1. 将JSON模式文件放入 src/mcp_gennx/schemas/raw/
2. 将端点添加到相应的子服务器 ENDPOINTS 字典

   # src/mcp_gennx/servers/modeling.py
   ENDPOINTS = {
       ...
       "db/NEW_ENDPOINT": {"tier": 2, "toolset": "modeling_advanced"},
   }

1. 重启服务器——工具会自动生成。

许可证

麻省理工学院