ZeroChain is a lightweight, zero-configuration C++ compilation and execution toolchain designed specifically for Model Context Protocol (MCP) clients (such as Google Antigravity or Claude Desktop). Developed and maintained by Click Done.
It allows AI agents to compile C++ source files, run binaries in a controlled sub-process with safety timeouts, and clean up workspace builds autonomously.
Features
- Zero Configuration: Automatically downloads and provisions a portable C++ compiler silently upon the first request.
- Space-Free Pathing: Bypasses classic linker spaces-in-path build bugs by forcing the compiler installation into a root directory (
C:\ZeroChain).
- Controlled Execution: Executes compiled binaries with strict process timeouts (default 5 seconds) to safeguard against infinite loops.
- Workspace Cleanliness: Exposes a cleanup tool so agents can delete binary artifacts once they finish execution.
1. compile_cpp
Compiles C++ source files into a static binary executable.
- Arguments:
files (Array of Strings, required): Absolute paths to the .cpp source files.outputName (String, required): Desired name/path of the output binary (e.g. app.exe).extraFlags (Array of Strings, optional): Additional compiler flags (e.g. ["-O3"]).
2. run_tests
Executes a compiled binary executable in a sandboxed process with a configurable timeout (default: 5000ms).
- Arguments:
binaryPath (String, required): Absolute path to the executable to run.args (Array of Strings, optional): Command line arguments to pass to the binary.
3. cleanup_binary
Deletes a compiled binary executable from the disk to keep the project workspace clean.
- Arguments:
binaryPath (String, required): Absolute path to the executable file to delete.
Configuration
To add ZeroChain to your MCP Client, add the following configuration block:
Claude Desktop / Antigravity Config (mcp_config.json or claude_desktop_config.json)
{
"mcpServers": {
"zerochain": {
"command": "C:/Program Files/nodejs/node.exe",
"args": ["C:/Projects/35-ZeroChain/dist/index.js"]
}
}
}
(Ensure you adjust the path to dist/index.js to match where this project is located on your disk.)
Development & Test
Installation
Ensure dependencies are installed:
npm install
Build
Compile the TypeScript code to JavaScript:
npm run build
Test
Run the native integration test suite (covers compilation, execution, timeouts, and cleanup):
npm run test
