X4CodeSense

What the X4CodeSense MCP server does

The X4CodeSense MCP server provides MCP access to the analysis library used by X4CodeSense. Its target language is the scripting used by X4: Foundations, including AI scripts and Mission Director scripts. The package is intended for AI agents that write or inspect these scripts rather than for general-purpose programming languages.

The available capabilities cover script checks, schema elements, expression types, scripts, cues, and texts. Together, these let an agent inspect the structures and language concepts needed to produce or review X4 script content. The server is part of a larger repository that also contains a language server, a command-line checker, a catalog reader, and a VS Code extension.

How it works

The MCP package is named x4-script-mcp and is built on x4-script-core, the project’s editor-independent analysis library. The core handles script detection, XML structure, expression language concepts, types, scopes, symbols, diagnostics, and ReadText calls in Lua files. The MCP layer exposes relevant parts of that analysis model to AI agents.

The repository describes the MCP server as one of the components bundled into the VS Code extension. The extension places the server and the other project packages in its distribution and makes the MCP server available to VS Code’s agents. The project also publishes the x4-script-mcp package to npm and registers it in the MCP Registry under io.github.chemodun/x4-script-mcp.

Setup and configuration

For users working in VS Code, installing the X4CodeSense extension is the documented route to using the MCP server with VS Code agents. The extension is available through the Visual Studio Marketplace and Open VSX, and release artifacts include a .vsix package.

Building the repository from source requires Node.js 22. The main build installs dependencies, builds all packages, and bundles the client distribution. The repository does not document MCP-specific environment variables or a separate runtime configuration in the provided material.

Optional variables such as X4_EXTRACTED, X4_GAME, and X4_MODS are described for the project’s corpus tests. They configure test inputs containing extracted game files, an installed X4: Foundations game, or extension folders; they are not identified as required MCP server settings.

Tools and capabilities

The X4CodeSense MCP server exposes capabilities for:

• Checking X4 script content.
• Inspecting schema elements.
• Looking up expression types.
• Accessing script information.
• Working with Mission Director cues.
• Accessing text data used by scripts.

These capabilities are backed by the same analysis foundation used by the project’s language server and command-line checker. The provided material does not specify individual MCP tool names, argument schemas, return formats, or authentication options.

Limitations and notes

The repository labels the MCP package and its supporting libraries as 0.x, while the extension and command-line checker are described as stable from version 1.0.0. That distinction matters when evaluating API stability for integrations built directly against x4-script-mcp.

The material identifies VS Code agents as a supported consumer through the bundled extension. It does not document compatibility details for other MCP clients, transport choices, per-tool schemas, or a standalone configuration example. Avoid assuming those details without consulting the package’s current documentation or release contents.

The server focuses on X4: Foundations script analysis. It should not be treated as a general game automation interface or as a replacement for the full VS Code language client.