English Français العربية

MIDAS Gen NX / Civil NX

السجل الرسمي الذكاء الاصطناعي والوكلاء

Read and carefully change the model open in MIDAS Gen NX or Civil NX on this PC.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع MIDAS Gen NX / Civil NX؟

  • "Summarise the Gen model." - node, element, material, section, load case counts
  • "Show the DL reactions." - result tables after an analysis
  • "Show me the model." - a picture of the NX window
  • "Which design code is set?" - design parameter tables
  • "Add a node at (4, 3, 0)", "Run the analysis" - previewed, applied only after you agree

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package midas-nx-mcp
Claude Code 
claude mcp add midas-gen-nx-civil-nx -e 'MIDAS_MAPI_KEY_GEN=<your midas_mapi_key_gen>' -e 'MIDAS_MAPI_KEY_CIVIL=<your midas_mapi_key_civil>' -e 'MIDAS_OUTPUT_DIR=<MIDAS_OUTPUT_DIR>' -- uvx midas-nx-mcp==0.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "midas-gen-nx-civil-nx": {
            "command": "uvx",
            "args": [
                "midas-nx-mcp==0.3.0"
            ],
            "env": {
                "MIDAS_MAPI_KEY_GEN": "<your midas_mapi_key_gen>",
                "MIDAS_MAPI_KEY_CIVIL": "<your midas_mapi_key_civil>",
                "MIDAS_OUTPUT_DIR": "<MIDAS_OUTPUT_DIR>"
            }
        }
    }
}

متغيرات البيئة

  • MIDAS_MAPI_KEY_GEN سري Gen NX MAPI key (Apps > API Settings in Gen NX). Needed for product=gen.
  • MIDAS_MAPI_KEY_CIVIL سري Civil NX MAPI key (Apps > API Settings in Civil NX). Needed for product=civil.
  • MIDAS_OUTPUT_DIR Folder NX writes captures and saved copies into. Must exist. Default C:/temp.
MCPB package https://github.com/Dennis5882/midas-nx-mcp/releases/download/v0.3.0/midas-nx-mcp-0.3.0.mcpb

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. midas-nx-mcp
  2. What you can ask
  3. Requirements
  4. Install
  5. Settings
  6. Tools
  7. Development
  8. License

midas-nx-mcp

A local MCP server that lets Claude (and other MCP clients) read the model open in MIDAS Gen NX or MIDAS Civil NX, and change it only through steps you see and confirm first. Built on the midas-nx SDK.

Personal, employee-led project; not an official MIDAS IT product.

Status: alpha. Verified live on Gen NX 2026 and Civil NX 2026 on small test models (see PLAN.md); not yet used on large production models.

사용 설명서 (한국어): docs/user_guide_ko.md

What you can ask

  • "Summarise the Gen model." - node, element, material, section, load case counts
  • "Show the DL reactions." - result tables after an analysis
  • "Show me the model." - a picture of the NX window
  • "Which design code is set?" - design parameter tables
  • "Add a node at (4, 3, 0)", "Run the analysis" - previewed, applied only after you agree

Requirements

  • Windows, with Gen NX or Civil NX running on the same PC and its Open API connected (Apps > API Settings)
  • A MAPI key per product (Apps > API Settings in each program). Keys differ between Gen and Civil, and a wrong key still reports "connected", so do not swap them.
  • uv (installs Python and the server for you); not needed for the Claude Desktop bundle below

Install

Claude Desktop - one click

Download midas-nx-mcp-<version>.mcpb from the latest release and open it (or drag it onto Settings > Extensions). Claude Desktop installs Python and the server itself, and asks for your Gen and Civil keys; leave the one you do not use empty. Change them later under Settings > Extensions.

Claude Desktop - by hand

Settings > Developer > Edit Config (not "Add custom connector": that is for remote servers) and add:

{
  "mcpServers": {
    "midas-nx": {
      "command": "uvx",
      "args": ["midas-nx-mcp"],
      "env": {
        "MIDAS_MAPI_KEY_GEN": "your Gen NX key",
        "MIDAS_MAPI_KEY_CIVIL": "your Civil NX key"
      }
    }
  }
}

Quit Claude Desktop completely (tray icon too) and start it again. Settings > Developer should show midas-nx as running.

Claude Code
claude mcp add midas-nx -e MIDAS_MAPI_KEY_GEN=your-gen-key -- uvx midas-nx-mcp
Other clients (Codex, ...)

Add a STDIO server with command uvx, argument midas-nx-mcp, and the environment variables below.

Settings

variabledefaultmeaning
MIDAS_MAPI_KEY_GEN-Gen NX key. Needed for product="gen"
MIDAS_MAPI_KEY_CIVIL-Civil NX key. Needed for product="civil"
MIDAS_TIMEOUT20seconds per call. Short on purpose: a dialog in NX blocks the API
MIDAS_ANALYSIS_TIMEOUT300seconds for run_analysis only
MIDAS_SAVE_TIMEOUT120seconds for save_copy only
MIDAS_MAX_ROWS200most rows one call returns; the rest are counted, not sent
MIDAS_OUTPUT_DIRC:/tempwhere NX writes captures. Must exist

Tools

Reading (nothing in the model changes):

toolwhat it returns
check_connection(product)connected or not, program name
list_tables(product?, search?)the /db and /DESIGN tables midas-nx knows
describe_table(product, table)NX's own field schema for a /db table
read_table(product, table, ids?, limit?)records, capped at MIDAS_MAX_ROWS
model_summary(product)counts of the main tables, and the unit system
read_model_info(product, what)project status, section properties, story check parameters, current selection
list_result_tables(search?)the result table types result_table accepts
result_table(product, table_type, load_cases?, components?, keys?, limit?)one result table; nothing exported
capture_view(product, width?, height?)the NX window as a PNG

Changing - each is called twice: first a preview with a confirm_token, then the same call with that token. It applies only if nothing changed in between, and reads the table back afterwards:

toolwhat it does
run_analysis(product)runs the analysis. NX saves the open file first; a never-saved document is refused. A dialog NX opens meanwhile is reported at once
save_copy(product)Save As to a generated name in MIDAS_OUTPUT_DIR; NX then works on the copy and the original stays as last saved. Gives a new document a file
write_records(product, table, records, mode)creates or updates up to 50 /db or /DESIGN records
delete_records(product, table, ids)deletes up to 50 records by id; nodes still used by elements are refused; a /DESIGN record NX resets instead of removing is reported as such

Any write discards the analysis results in NX (even one that stores the same value); run the analysis again before reading results.

Never exposed: new/open/import document, emptying a table.

Development

git clone https://github.com/Dennis5882/midas-nx-mcp
cd midas-nx-mcp
python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"
copy .env.example .env      # a checkout reads its .env; an installed package does not
pytest
ruff check src tests scripts
npx @modelcontextprotocol/inspector .venv\Scripts\python.exe -m midas_nx_mcp.server

AGENTS.md holds the safety rules every tool follows, and PLAN.md what has been verified live and what is open.

License

MIT

الأسئلة الشائعة

ما هو MIDAS Gen NX / Civil NX؟

Read and carefully change the model open in MIDAS Gen NX or Civil NX on this PC.

كيف أثبّت MIDAS Gen NX / Civil NX؟

يعمل على جهازك. في Claude Code: claude mcp add midas-gen-nx-civil-nx -e 'MIDAS_MAPI_KEY_GEN=<your midas_mapi_key_gen>' -e 'MIDAS_MAPI_KEY_CIVIL=<your midas_mapi_key_civil>' -e 'MIDAS_OUTPUT_DIR=<MIDAS_OUTPUT_DIR>' -- uvx midas-nx-mcp==0.3.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج MIDAS Gen NX / Civil NX إلى مفتاح API؟

نعم. يتطلب MIDAS_MAPI_KEY_GEN, MIDAS_MAPI_KEY_CIVIL، وتضبطها في إعداداته.

هل MIDAS Gen NX / Civil NX مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون MIDAS Gen NX / Civil NX؟

ينشره Dennis5882. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.