# X4CodeSense [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/chemodun/X4CodeSense  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/x4codesense

## Description
X4: Foundations scripts: checks, schema elements, expression types, scripts, cues and texts.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/x4codesense/readme_