Skip to main content
Glama
Sign In
AniketSpecter

jack-map

by AniketSpecter
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

JACK Codex MCP

An unofficial Windows MCP server and native C++ plugin for assisted mapping in J.A.C.K. Map Editor. Inspect maps, read live selection, and preview/apply limited native brush and entity edits through Codex or another stdio MCP client.

Version 0.3.0-alpha.1 — experimental, not a complete editor SDK. Native editing is validated only against J.A.C.K. 1.1.3773 Freeware x64 with the exact executable fingerprint in compatibility. Other versions fail closed. J.A.C.K. and game assets are not included.

Known save issue: native changes do not reliably trigger JACK's unsaved star/close prompt. Editing is opt-in and restricted to staged working copies. After each accepted batch, use File > Save As to save a JMF and verify it by reopening. SDK recovery JSON is not a full JMF backup. See safety.

Quick start

Requires Windows x64, Python 3.11+, a configured supported JACK installation, and Codex CLI for automatic registration. Native compilation additionally needs Git, Visual Studio C++ Build Tools (x64), Windows SDK and CMake 3.20+.

git clone https://github.com/AniketSpecter/jack-codex-mcp.git
cd jack-codex-mcp
powershell -NoProfile -ExecutionPolicy Bypass -File .\setup.ps1 -BuildNative -DesktopShortcut

Setup asks for your editor and project paths. It installs dependencies in .venv, builds the plugin, and registers jack-map if Codex CLI is present. An existing registration is preserved unless you explicitly pass -ReplaceMcp. Reconnect/restart your MCP client after installation.

Open Start JACK Codex.cmd, import a map copy, and maximize the map document inside JACK. Read-only native sessions are the default. First test experimental editing on a new disposable map; check its opt-in box when ready.

Ask your assistant:

Inspect the current JACK document and selection. Do not change anything.

On this disposable map, preview a 64 × 64 × 64 box at [0, 0, 32]. Show the exact operations and wait for my approval before applying them.

Installation · Step-by-step tutorial · Tools · Testing · Roadmap

Related MCP server: PocketDraft MCP

What works

Capability

Status / limits

MAP parsing, entity search, compile-log diagnosis

Implemented; heuristic, not a compiler

Window discovery / screenshots

Implemented; visible desktop captures can be occluded

Native document and selection reads

Automatic editor-thread snapshots; bounded output

Create / duplicate / move world brushes

Experimental; convex geometry, bounded inputs

Rotate world brushes

Experimental; Z axis only; texture-lock not guaranteed

Create / move point entities and edit properties

Experimental; restricted class/key allowlists

Change preview / revision checks / checkpoints

Implemented; exact one-use plan tokens

Editor Undo transaction recording

Implemented; creation Undo/Redo manually tested

Mouse / keyboard MCP tools

Separate opt-in; disabled by setup

Native select, delete, Save, Undo/Redo invocation

Not implemented

Reliable host modified-document notification

Unresolved — Save As required

All JACK versions, Linux/macOS native plugin

Not supported

The launcher copies the user's installed editor locally and loads the plugin there. It never patches the executable, installs the plugin into the original installation, or automatically installs maps into a game.

Contribute

Read CONTRIBUTING.md, architecture and compatibility. Contributions welcome: save notification, document identity, native selection, broader tests, tutorials and compatibility. Report security problems through SECURITY.md.

Project code is MIT licensed. SDK headers and other dependencies retain their own licenses: THIRD_PARTY_NOTICES.md. This is independent of the JACK developers, Valve and OpenAI.

This server cannot be deployed

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Wulfram Forge MCP

    Mojowjoejoe
    F
    license
    B
    quality
    B
    maintenance
    This server enables MCP clients to inspect and edit the currently open map in the Wulfram Forge desktop editor, including moving mirrored structures, shaping terrain, capturing views, validating placements, exporting copies, and undoing changes.
    10
    -
  • PocketDraft MCP by iPocket-APP

    PocketDraft MCPofficial

    iPocket-APP
    F
    license
    A
    quality
    B
    maintenance
    Enables MCP agents to inspect and precisely edit a paired browser editor project through local stdio, with batch commands, previews, exports, validation, and guarded undo/redo while keeping changes hand-editable.
    11
    -

  • paradox-toolkit

    JDeffner
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP clients to research game mods by searching documentation and definitions, inspecting dependencies and playsets, validating saved files with structural and Tiger checks, and preparing or editing mod content with preview and write controls. It also supports starting or previewing the game through a local stdio connection.
    35 npm
    GPL 3.0

  • maxplus2-mcp

    Hachimeder
    A
    license
    B
    quality
    A
    maintenance
    Enables any local stdio MCP client to read and edit MAX+plus II projects, GDF schematics, SYM symbols and SCF waveforms, run the vendor's native compilation and simulation, and drive MAX+plus II's Windows user interface through Win32 and UI Automation.
    68
    3
    MIT