simos-mcp

MCP server for Simos 18.1 ECU tuning — read, write, diff, and validate XDF/BIN files.

What it does

Reads XDF definition files and BIN binary files, letting you:

• List all tables and scalars in an XDF

• Read table data (2D maps) with proper axis labels and scaled values

• Read scalar values (single parameters)

• Write table data back to BIN files

• Write scalar values back to BIN files

• Diff two BIN files to see what changed

• Validate tables against their min/max ranges

• Search for tables by name (fuzzy matching via rapidfuzz)

Related MCP server: MCP X++ Server

Setup

Requires Python 3.10+ and the rapidfuzz package.

pip install rapidfuzz

Or, if using the project's pyproject.toml:

pip install -e .

VS Code MCP config

Add to .vscode/mcp.json:

{
  "servers": {
    "simos-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["path/to/simos-mcp/server.py"]
    }
  }
}

Or run directly

cd path/to/simos-mcp
python server.py

Tools

How it works

The XDF file is an XML definition that tells the parser:

• Where data lives in the BIN (addresses, data sizes)

• How to interpret it (signed/unsigned, endianness)

• How to scale raw values to human-readable units (MATH equations)

The parser handles:

• Embedded axis data (read from BIN)

• Label-based axes (defined in XDF)

• Linked axes (cross-references between tables)

• MATH equation transformation (forward and inverse)

• Both ECU (Simos 18.1) and TCU (DQ250) XDF formats

• Automatic endianness detection from mmedtypeflags

Tested with

• SC8S50_switchpatch29.33_v1.006.xdf (ECU, Simos 18.1)

• F45M_DSG_v1.007.xdf (TCU, DQ250)