MCP 服务器

OneTech MCP Server

Enables AI assistants to extract and document Mendix Studio Pro modules by interrogating local .mpr files. Generates comprehensive JSON documentation of domain models, pages, microflows, and enumerations without sending data to the cloud.

README

OneTech MCP Server

Extract and document Mendix Studio Pro modules via Model Context Protocol (MCP)

OneTech MCP Server enables AI assistants like GitHub Copilot to interrogate local Mendix .mpr files and extract comprehensive module documentation including domain models, pages, microflows, and enumerations.

🚀 Quick Start

Install Globally (Recommended)

npm install -g @jordnlvr/onetech-mcp-server

Or Use with NPX (No Install)

npx @jordnlvr/onetech-mcp-server

Configure in VS Code

Add to your VS Code settings.json:

{
	"github.copilot.chat.mcp.enabled": true,
	"github.copilot.chat.mcp.servers": {
		"onetech": {
			"command": "npx",
			"args": ["@jordnlvr/onetech-mcp-server"]
		}
	}
}

Or use global install:

{
	"github.copilot.chat.mcp.enabled": true,
	"github.copilot.chat.mcp.servers": {
		"onetech": {
			"command": "onetech-mcp-server"
		}
	}
}

📚 Usage

Once configured, use GitHub Copilot to extract module documentation:

You: "Extract the RequestHub module from D:\Projects\OneTech.mpr"

Copilot: [Uses onetech_extract_module tool]
✅ Successfully extracted 4 files from module 'RequestHub':
  - DomainModel.json (57KB)
  - Pages.json (42KB)
  - Microflows.json (0KB)
  - Enumerations.json (4KB)

🛠️ Available Tools

`onetech_extract_module`

Extracts domain model, pages, microflows, and enumerations from a Mendix module using mx.exe.

Parameters:

mprPath (required): Absolute path to the .mpr file
moduleName (required): Name of the module to extract
outputPath (required): Absolute path to output directory for JSON files
mxPath (optional): Path to mx.exe (default: D:\Program Files\Mendix\11.3.0.80734\modeler\mx.exe)

Returns:

JSON files containing complete module structure
File sizes and extraction status
Success/error messages

📋 Requirements

Node.js: >= 18.0.0
Mendix Studio Pro: Version 11.3.0 or compatible
mx.exe: Command-line tool (included with Studio Pro)

🔒 Privacy & Security

100% Local: All processing happens on your machine
No Cloud: Your .mpr files never leave your computer
No Tracking: No telemetry, analytics, or data collection
Open Source: Full transparency, audit the code yourself

🎯 Use Cases

Documentation Generation: Extract module structure for AI-powered docs
Code Review: Analyze domain models and microflows
Migration Planning: Understand module dependencies
Teaching: Demonstrate Mendix architecture to students
Onboarding: Help new developers understand existing apps

📦 What Gets Extracted

For each module, the tool generates 4 JSON files:

DomainModel.json: Entities, attributes, associations, validation rules
Pages.json: Page layouts, widgets, data sources
Microflows.json: Logic flows, actions, parameters
Enumerations.json: Enumeration types and values

🏗️ Architecture

Your Machine
├── VS Code + GitHub Copilot
├── OneTech MCP Server (this package)
│   └── Calls mx.exe with your .mpr file
├── mx.exe (Mendix CLI)
└── Your .mpr files (local, never uploaded)