Cpp Builder

This MCP server lets you build and analyze C++ DLLs using Visual Studio build tools, exposing a simple programmatic interface for compiling DLLs with custom export definitions and inspecting their exports. It integrates MSBuild for compilation and dumpbin for export analysis, giving you end-to-end control over build configurations, platforms, and export behavior.

How to use

You will interact with the C++ Builder MCP Server through an MCP client. The server exposes two primary capabilities: compiling a C++ DLL with a specified project and export definitions, and analyzing the exports of a compiled DLL. Use the client to request a DLL build in Debug or Release mode, targeting x86 or x64, and optionally supply a .def file to control which functions are exported. After building, you can analyze the resulting DLL to obtain a full export table, ordinals, addresses, and any export forwarding information.

Typical usage patterns include:

How to install

Prerequisites you need before installation are: Node.js (with npm) and access to a Windows environment with Visual Studio 2022 or newer (for MSBuild and C++ tools). Ensure you have Visual C++ build tools and the Windows SDK installed.

Install and set up the MCP server locally by following these steps exactly:

# Step 1: Clone the MCP server repository
git clone https://github.com/yourusername/cpp-builder-mcp-server.git
cd cpp-builder-mcp-server

# Step 2: Install dependencies
npm install

# Step 3: Build the project
npm run build

Configure the MCP client to use the server

Add the server to your MCP settings so your client can communicate with it. Use the following configuration snippet.

{
  "mcpServers": {
    "cpp-builder": {
      "command": "node",
      "args": ["path/to/cpp-builder-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

Usage examples

Compile a DLL with default settings using the most common project path.

// Basic compilation
await mcp.use("cpp-builder", "compile_dll", {
  projectPath: "./src/MyLibrary.vcxproj"
});

Compile a DLL with explicit settings such as Debug configuration and x64 platform, using a .def file to control exports.

await mcp.use("cpp-builder", "compile_dll", {
  projectPath: "./src/MyLibrary.vcxproj",
  configuration: "Debug",
  platform: "x64",
  defFile: "./src/exports.def"
});

Analyze the exports of a built DLL to inspect the export table, ordinals, and any forwarding information.

await mcp.use("cpp-builder", "analyze_exports", {
  dllPath: "./bin/Release/MyLibrary.dll"
});

Notes on requirements and environment

This server relies on Visual Studio 2022 Community Edition or newer, the Visual C++ build tools, and the Windows SDK for building C++ DLLs.

Development notes

If you plan to contribute, clone the repository, run tests, and build to verify changes.

npm test
npm run build

License

MIT license applies to this MCP server.

Available tools

compile_dll

Compiles a C++ DLL using MSBuild with optional configuration, platform, and .def-based exports to control which symbols are exposed.

analyze_exports

Analyzes a compiled DLL to list all exports, their ordinals and addresses, and any export forwarding information.