Skip to content

MAPI-LAB/midas-api-agent-release

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 

Repository files navigation

MAPI STUDIO Beta

English · 한국어


MAPI STUDIO Beta — English

Agent-First Engineering Workspace for MIDAS CIVIL NX and GEN NX

MAPI STUDIO - CIVIL NX Model Creation Agent Session

Beta Notice MAPI STUDIO is currently in Beta. Some API schema information and Python example code are still being improved. Please check for the latest updates before use.

MAPI STUDIO is a local desktop AI workspace designed for MIDAS CIVIL NX and MIDAS GEN NX users.

It integrates the MIDAS Product API, official engineering manuals, API schemas, MCP tools, a built-in API tester, AI Agent, result analysis, and automation code generation into a single desktop application.

MAPI STUDIO is built on the Nimbalyst Agent Platform, extended with MIDAS-specific engineering capabilities.

Users can complete their entire workflow — from API reference to testing, execution, result analysis, and code generation — without switching between separate tools.

Question → API Search → Schema Understanding → API Test → Execute → Analyze Results → Generate Code

What is MAPI STUDIO?

MAPI STUDIO is not just an API manual viewer.

It is an Agent-first engineering workspace for MIDAS Product API users.

MAPI STUDIO helps users:

  • Search and understand MIDAS Product APIs
  • Explore enhanced API schemas
  • Test API calls without a separate REST client
  • Execute MIDAS Product REST APIs
  • Analyze large result tables
  • Use MCP tools through an AI Agent
  • Generate Python, JavaScript, and TypeScript automation code
  • Build repeatable engineering workflows

Why MAPI STUDIO?

MIDAS Product API provides powerful access to modeling, analysis, design, and result data.

However, using an API-based workflow typically requires prior knowledge of:

  • Which endpoint to use
  • What each request field means
  • How to structure the JSON request body
  • Which fields are required vs. optional
  • Which enum/dropdown values are valid
  • How to handle API authentication
  • How to safely test API calls
  • How to interpret large response tables
  • How to turn a successful API call into reusable automation code

Existing API manuals are useful references, but they require users to search for information first.

MAPI STUDIO starts differently.

Users describe what they want in natural language, and the Agent guides them step by step — finding the right API, explaining the schema, executing the call, interpreting results, and generating automation code.

Examples:

How do I get the Node data from the current model?
Create 3 nodes in the current model.
Which API should I use to get Beam Force results?
Show me the Beam Force result table.
Write a Python script to save this result table as CSV.
Capture the current modeling view.

Key Features

1. Official MIDAS API Manual

MAPI STUDIO includes the official MIDAS Product API manual built in.

Users can look up endpoint specifications directly inside MAPI STUDIO without opening a separate browser.

MIDAS API Manual - Material Properties endpoint overview

  • Purpose-based API search
  • Endpoint descriptions and request/response examples
  • Required and optional field reference
  • Enum/dropdown value reference
  • Expected response structure and result table format
  • Ask the Agent about any API
How do I create a Beam Element?

2. Advanced Schema Explorer

MIDAS APIs often involve nested JSON structures and complex request formats.

MAPI STUDIO goes beyond the official manual by providing a visual schema explorer that shows each field's type, whether it is required, enum values, and nested structures.

Beta Notice: Schema information for some endpoints is still being improved. Content may be incomplete or differ from official documentation. Always check for the latest version.

Schema Explorer - Material Properties field details with Required/Optional distinction

  • Request and response schema view
  • Required field highlighting and enum value descriptions
  • Nested object exploration and example JSON generation
Explain the request schema for this API.
Generate an example JSON body for creating a Material.

3. Built-in API Tester

MAPI STUDIO provides a built-in API testing environment.

No need to install Postman, Insomnia, Thunder Client, or write cURL scripts. API calls can be configured, executed, and reviewed directly inside MAPI STUDIO.

Built-in REST API Tester - Builder UI and Request Runner

  • Base URL and MAPI-Key management
  • HTTP method selection and endpoint execution
  • Request body editing with JSON formatting
  • Response, response time, and error review
  • Execution history
Run the NODE GET API and show me the response.

4. API Unit Testing Workflow

MAPI STUDIO can be used as a lightweight unit testing environment for MIDAS API workflows.

Users can test individual API calls before writing a full automation script.

Select API → Build Request → Run Test → Check Response
    → Adjust Schema/Payload → Validate Workflow → Generate Code

5. Live MIDAS Product API Execution

  • Configure MIDAS Product API Base URL and MAPI Key locally
  • Execute REST API calls against the active product environment
  • Read/write model data, query results, capture views, export CSV

6. Automation Code Generation

Python Tab - Pydantic-based automation code generation

Agent Session - Python script generation and execution

Beta Notice: Python example code is continuously being improved. Always review generated code before running it, and check for the latest updates.

Generates Python, JavaScript, and TypeScript automation code. Generated code reads the Base URL and API Key from the MAPILAB config at runtime and never hardcodes credentials.

Write a Python script to query Beam Force and save the full results as CSV.
Create a JavaScript script to generate nodes and beam elements using the MIDAS API.

7. Agent-Based API Support

MAPI STUDIO is centered around an AI Agent interface.

Agent Session - API schema query and MCP tool execution

Which API should I use to get Beam Force results?
Create 10 nodes at 5m intervals.
Why did this API request fail?
Summarize this result table.

8. MIDAS MCP Tools

MAPI STUDIO includes MCP-based tools for MIDAS Product API workflows.

MCP Servers Settings - mapilab server connected successfully

  • Node / Element / Section / Material / Load operations
  • Analysis result query / Result table extraction / View capture
Get all nodes in the current model.
Show me the Beam Force result table.
Capture the current modeling view.

The Agent can capture live result visualizations directly from CIVIL NX and display them inline in the session.

Agent Session - Beam Force result image captured from CIVIL NX


9. Large Result Table Analysis

Agent Session - Beam Force Table CSV export workflow

Instead of dumping thousands of rows into the chat, the Agent summarizes results and guides users through CSV export.

Summarize the Beam Force result table.
Export the full result table as CSV.

Exported CSV files can be opened and reviewed directly inside MAPI STUDIO using the built-in spreadsheet viewer — no need to switch to Excel or another application.

Built-in CSV Spreadsheet Viewer - Beam Force Table result

  • Column-by-column review of exported result tables
  • Instant preview after export without leaving the workspace

10. Built on Nimbalyst Agent Platform

MAPI STUDIO is built on the Nimbalyst Agent Platform.

Nimbalyst provides a local Agent workspace, session management, visual collaboration environment, file-based workflows, task management, and a tool integration framework.

Claude Agent Settings - Built-in SDK, Authentication, Tool Permissions

  • Local desktop Agent workspace
  • Multi-session and parallel Agent session management
  • Session search and resume / Kanban-style management
  • MCP integration / local tool execution
  • Visual editor / file-based workflow

11. Visual Agent Workspace

Because MAPI STUDIO is built on Nimbalyst, it is not limited to a chat-only interface.

Users can work with Markdown documents, API docs, code files, CSV data, diagrams, engineering notes, task boards, session history, and project files — all within one Agent workspace.


12. Session and Task Management

Engineering automation work rarely ends with a single question.

Session 1: Explore Node and Element APIs
Session 2: Test Result Table APIs
Session 3: Generate Python automation code
Session 4: Review and improve generated scripts

13. Developer Workflow Support

Manage code files, automation scripts, Markdown notes, task plans, Agent sessions, and local project files together in one workspace — connecting API testing directly to automation development.


First Run Setup

Required configuration: MIDAS Product API Base URL / MAPI Key

These values are stored locally on the user's PC. They are not included in the installer.

Reference: https://support.midasuser.com/hc/en-us/articles/30508934444569-Base-URL-and-API-KEY


Security and Local Settings

Base URL, MAPI Key, and Product connection settings are not included in the installer. Each user configures their own connection after installation. Generated automation code never hardcodes or exposes API keys.


Typical Workflows

Ask which API to use
→ I want to get node data from the current model. Which API should I use?

Understand the API schema
→ Explain the request body for creating a Beam Element.

Test the API directly
→ Run the NODE GET API and show me the response.

Query a result table
→ Summarize the Beam Force result table.

Generate automation code
→ Write a Python script to query the Beam Force table and save all results as CSV.

Installation

MAPI-STUDIO-Windows-x64.exe

Download the installer from the latest Release and run it.


Who Is This For?

  • Structural / Civil / Bridge Engineers
  • MIDAS CIVIL NX / GEN NX users
  • MIDAS Product API users
  • Engineering Automation Developers

Architecture Overview

User
  ↓
MAPI STUDIO Desktop App
  ↓
Nimbalyst Agent Platform
  ↓
MCP Tools + Manual Search + Schema Metadata
  ↓
MIDAS Product API
  ↓
CIVIL NX / GEN NX

Acknowledgements

MAPI STUDIO is built on the Nimbalyst Agent Platform.

Nimbalyst is an open-source project available under the MIT License.


License and Usage

MAPI STUDIO is proprietary software. Commercial use, redistribution, resale, modification, reverse engineering, or repackaging without prior written permission from the copyright holder is prohibited.

Copyright © 2026. All rights reserved.


▲ Top · 한국어 →



MAPI STUDIO Beta — 한국어

MIDAS CIVIL NX 및 GEN NX를 위한 Agent-First 엔지니어링 워크스페이스

MAPI STUDIO - CIVIL NX 모델 생성 Agent 세션

Beta 안내 MAPI STUDIO는 현재 Beta 버전입니다. 일부 API 스키마 정보와 Python 예제 코드는 지속적인 고도화가 진행 중입니다. 사용 전 최신 업데이트를 확인하시기 바랍니다.

MAPI STUDIO는 MIDAS CIVIL NXMIDAS GEN NX 사용자를 위해 설계된 로컬 데스크톱 AI 워크스페이스입니다.

MAPI STUDIO는 MIDAS Product API, 공식 엔지니어링 매뉴얼, API 스키마, MCP 도구, 내장 API 테스트 기능, AI Agent, 결과 분석, 자동화 코드 생성을 하나의 데스크톱 애플리케이션으로 통합합니다.

MAPI STUDIO는 Nimbalyst Agent Platform을 기반으로 구축되었으며, 여기에 MIDAS 전용 엔지니어링 기능을 확장한 제품입니다.

사용자는 API 매뉴얼, REST API 테스트 도구, 엔지니어링 문서, Python 스크립트, JavaScript 파일, 외부 AI 도구를 오가며 작업할 필요 없이 하나의 환경에서 전체 워크플로우를 수행할 수 있습니다.

질문 → API 탐색 → 스키마 이해 → API 테스트 → 실행 → 결과 분석 → 자동화 코드 생성

MAPI STUDIO란?

MAPI STUDIO는 단순한 API 매뉴얼 뷰어가 아닙니다.

MIDAS Product API 사용자를 위한 Agent-first 엔지니어링 워크스페이스입니다.

MAPI STUDIO는 사용자가 다음 작업을 더 쉽게 수행할 수 있도록 돕습니다.

  • MIDAS Product API 검색 및 이해
  • 개선된 API 스키마 탐색
  • 별도 API 프로그램 없이 API 호출 테스트
  • MIDAS Product REST API 실행
  • 대용량 결과 테이블 분석
  • AI Agent를 통한 MCP 도구 사용
  • Python, JavaScript, TypeScript 자동화 코드 생성
  • 반복 가능한 엔지니어링 워크플로우 구성

MAPI STUDIO는 엔지니어링 질문에서 실제 동작하는 API 기반 솔루션까지 더 빠르게 이동하기 위한 도구입니다.


왜 MAPI STUDIO가 필요한가?

MIDAS Product API는 모델링, 해석, 설계, 결과 데이터에 접근할 수 있는 강력한 기능을 제공합니다.

하지만 API 기반 워크플로우를 사용하려면 사용자가 이미 다음 내용을 알고 있어야 하는 경우가 많습니다.

  • 어떤 endpoint를 사용해야 하는지
  • 각 request field가 무엇을 의미하는지
  • JSON request body를 어떻게 구성해야 하는지
  • 어떤 field가 필수이고 어떤 field가 선택인지
  • 어떤 enum/dropdown 값이 유효한지
  • API 인증을 어떻게 처리해야 하는지
  • API를 어떻게 안전하게 테스트해야 하는지
  • 큰 응답 테이블을 어떻게 해석해야 하는지
  • 성공한 API 호출을 어떻게 반복 가능한 자동화 코드로 바꿀 수 있는지

기존 API 매뉴얼은 참고자료로는 유용하지만, 보통 문서를 먼저 찾아야 합니다.

MAPI STUDIO는 시작점이 다릅니다.

사용자는 자연어로 원하는 작업을 설명하고, Agent가 필요한 API, 스키마, 호출 방식, 결과 해석, 자동화 코드 생성을 단계적으로 도와줍니다.

예시:

현재 모델의 Node 정보를 가져오려면 어떻게 해야 하나요?
현재 모델에 Node 3개를 생성해줘.
Beam Force 결과를 가져오려면 어떤 API를 써야 하나요?
Beam Force 결과 테이블을 보여줘.
이 결과 테이블을 CSV로 저장하는 Python 코드를 만들어줘.
현재 모델링 화면을 캡처해줘.

주요 기능

1. 공식 MIDAS API 매뉴얼

MAPI STUDIO는 MIDAS Product API 공식 매뉴얼을 내장하고 있습니다.

사용자는 별도 브라우저 없이 MAPI STUDIO 안에서 바로 endpoint 명세를 확인할 수 있습니다.

MIDAS API 매뉴얼 - Material Properties endpoint 개요

  • 목적 기반 API 검색
  • endpoint 설명 및 request/response 예제 확인
  • 필수/선택 field 및 enum/dropdown 값 확인
  • 예상 response 구조 및 결과 테이블 형식 이해
  • Agent에게 API 관련 질문
Beam Element를 생성하려면 어떻게 해야 하나요?

2. 고급 Schema Explorer

MIDAS API는 중첩된 JSON 구조와 복잡한 request 형식을 포함하는 경우가 많습니다.

MAPI STUDIO는 공식 매뉴얼을 넘어, 각 필드의 타입·필수 여부·enum 값·중첩 구조를 시각적으로 탐색할 수 있는 고급 schema 탐색 기능을 제공합니다.

Beta 안내: 일부 endpoint의 스키마 정보는 지속적으로 보강되고 있습니다. 내용이 불완전하거나 공식 문서와 다를 수 있으니 반드시 최신 버전을 확인하세요.

Schema Explorer - Material Properties 필드 상세 및 Required/Optional 구분

  • request / response schema 확인
  • 필수 field 강조, enum 값 설명
  • 중첩 object 탐색 및 예제 JSON 생성
이 API의 request schema를 설명해줘.
Material을 생성하는 예제 JSON body를 만들어줘.

3. 내장 API Tester

MAPI STUDIO는 내장 API 테스트 환경을 제공합니다.

Postman, Insomnia, Thunder Client, cURL 없이 MAPI STUDIO 안에서 직접 API를 실행하고 결과를 확인할 수 있습니다.

내장 REST API Tester - Builder UI와 Request Runner

  • Base URL / MAPI-Key 관리
  • HTTP method 선택 및 endpoint 실행
  • request body 편집, JSON formatting
  • response / response time / error 확인
  • 실행 이력 확인
NODE GET API를 실행하고 response를 보여줘.

4. API 단위 테스트 워크플로우

전체 스크립트를 먼저 작성하지 않고도 개별 API 동작을 검증할 수 있습니다.

API 선택 → Request 작성 → 테스트 실행 → Response 확인
    → Schema/Payload 수정 → Workflow 검증 → 자동화 코드 생성

5. Live MIDAS Product API 실행

  • MIDAS Product API Base URL 및 MAPI Key 로컬 설정
  • 활성 제품 환경에 대한 REST API 호출 실행
  • 모델 데이터 읽기/쓰기, 결과 query, 화면 capture, CSV export

6. 자동화 코드 생성

Python 탭 - Pydantic 기반 자동화 코드 생성

Agent 세션 - Python 스크립트 생성 및 실행

Beta 안내: Python 예제 코드는 지속적으로 고도화되고 있습니다. 생성된 코드는 실행 전 반드시 내용을 검토하고, 최신 업데이트를 확인하세요.

Python / JavaScript / TypeScript 자동화 코드를 생성합니다. 생성 코드는 MAPILAB config에서 Base URL과 API Key를 런타임에 읽으며, 코드에 credential을 노출하지 않습니다.

Beam Force를 가져와서 CSV로 저장하는 Python 코드를 만들어줘.
Node와 Beam Element를 생성하는 JavaScript 코드를 만들어줘.

7. Agent 기반 API 지원

MAPI STUDIO는 AI Agent 인터페이스를 중심으로 동작합니다.

Agent 세션 - API 스키마 구조 설명 및 MCP 도구 실행

Beam Force를 가져오려면 어떤 API를 써야 하나요?
5m 간격으로 Node 10개를 생성해줘.
이 API request가 왜 실패했는지 알려줘.
이 결과 테이블을 요약해줘.

8. MIDAS MCP Tools

MAPI STUDIO는 MIDAS Product API workflow를 위한 MCP 기반 도구를 포함합니다.

MCP Servers 설정 - mapilab 서버 연결 성공

  • Node / Element / Section / Material / Load 작업
  • 해석 결과 query / Result table 추출 / View capture
현재 모델의 모든 Node를 가져와줘.
Beam Force 결과 테이블을 보여줘.
현재 모델링 화면을 캡처해줘.

Agent가 CIVIL NX의 해석 결과 이미지를 직접 캡처하여 세션 내에 인라인으로 표시합니다.

Agent 세션 - CIVIL NX Beam Force 결과 이미지 캡처


9. 대용량 Result Table 분석

Agent 세션 - Beam Force Table CSV 내보내기 워크플로우

수천 개의 row를 chat에 그대로 출력하는 대신, Agent가 결과를 요약하고 CSV export를 안내합니다.

Beam Force 결과 테이블을 요약해줘.
전체 결과 테이블을 CSV로 내보내줘.

내보낸 CSV 파일은 MAPI STUDIO 내장 스프레드시트 뷰어에서 바로 열어 확인할 수 있습니다. Excel이나 다른 프로그램으로 전환할 필요 없이 워크스페이스 안에서 결과를 검토할 수 있습니다.

내장 CSV 스프레드시트 뷰어 - Beam Force 결과 테이블

  • 내보낸 결과 테이블을 컬럼 단위로 바로 확인
  • 내보내기 직후 워크스페이스를 벗어나지 않고 즉시 미리보기

10. Nimbalyst Agent Platform 기반

MAPI STUDIO는 Nimbalyst Agent Platform을 기반으로 구축되었습니다.

Nimbalyst는 로컬 Agent 워크스페이스, 세션 관리, 시각적 협업 환경, 파일 기반 작업, task 관리, tool integration framework를 제공합니다.

Claude Agent 설정 - Built-in SDK, 인증, Tool Permissions

  • 로컬 데스크톱 Agent workspace
  • Multi-session 관리 / 병렬 Agent session
  • session 검색 및 재개 / Kanban 스타일 관리
  • MCP integration / local tool execution
  • visual editor / 파일 기반 workflow

11. Visual Agent Workspace

단순한 chat 인터페이스가 아니라 Markdown 문서, API 문서, code file, CSV data, diagram, task board, session history를 하나의 workspace 안에서 관리할 수 있습니다.


12. Session 및 Task 관리

Session 1: Node 및 Element API 탐색
Session 2: Result Table API 테스트
Session 3: Python 자동화 코드 생성
Session 4: 생성된 script 검토 및 개선

13. Developer Workflow 지원

code file, automation script, Markdown note, task plan, Agent session, local project file을 하나의 workspace에서 관리하며 API 테스트와 자동화 개발을 연결할 수 있습니다.


First Run Setup

필수 설정: MIDAS Product API Base URL / MAPI Key

이 값들은 사용자의 PC에 로컬로 저장됩니다. installer에는 포함되지 않습니다.

참고: https://support.midasuser.com/hc/en-us/articles/30508934444569-Base-URL-and-API-KEY


Security and Local Settings

Base URL, MAPI Key, Product connection 정보는 installer에 포함되지 않습니다. 각 사용자가 설치 후 직접 설정하며, 생성되는 자동화 코드도 API key를 hardcoding하지 않습니다.


Typical Workflows

어떤 API를 써야 하는지 질문
→ 현재 모델의 Node 정보를 가져오고 싶습니다. 어떤 API를 사용해야 하나요?

API schema 이해
→ Beam Element를 생성하는 request body를 설명해줘.

API 직접 테스트
→ NODE GET API를 실행하고 response를 보여줘.

Result table query
→ Beam Force 결과 테이블을 요약해줘.

자동화 코드 생성
→ Beam Force table을 query하고 전체 결과를 CSV로 저장하는 Python 코드를 작성해줘.

Installation

MAPI-STUDIO-Windows-x64.exe

최신 Release에서 installer를 다운로드하여 설치합니다.


Who Is This For?

  • Structural / Civil / Bridge Engineer
  • MIDAS CIVIL NX / GEN NX 사용자
  • MIDAS Product API 사용자
  • Engineering Automation Developer

Architecture Overview

User
  ↓
MAPI STUDIO Desktop App
  ↓
Nimbalyst Agent Platform
  ↓
MCP Tools + Manual Search + Schema Metadata
  ↓
MIDAS Product API
  ↓
CIVIL NX / GEN NX

Acknowledgements

MAPI STUDIO는 Nimbalyst Agent Platform을 기반으로 구축되었습니다.

Nimbalyst는 MIT License로 제공되는 open-source project입니다.


License and Usage

MAPI STUDIO는 proprietary software입니다. 저작권자의 사전 서면 허가 없이 상업적 사용, 재배포, 재판매, 수정, 역공학, 재패키징을 금지합니다.

Copyright © 2026. All rights reserved.


← English · ▲ 맨 위로

About

Local MIDAS API Agent and Engineering Automation Platform

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors