Cpp Builder MCP Server

🚀 C++ Builder MCP Server

An MCP server that provides C++ DLL compilation and analysis capabilities. This server supports compiling C++ DLLs with specific export settings using Visual Studio build tools and analyzing DLL exports via dumpbin.

✨ Features

• Compile C++ DLLs using MSBuild.
• Customize export settings through .def files.
• Analyze DLL exports using dumpbin.
• Configurable build settings.
• Platform and configuration targets.
• Detailed build output.

🛠️ Tools

DLL Compilation

compile_dll

Compile a C++ DLL with specific export settings using MSBuild.

• projectPath: Path to the .vcxproj file (Required).
• configuration: Build configuration (Optional).
  • Values: 'Debug' or 'Release'.
  • Default: 'Release'.
• platform: Target platform (Optional).
  • Values: 'x86' or 'x64'.
  • Default: 'x86'.
• defFile: Path to the .def file (Optional).
  • Specify exported functions and their attributes.
  • Control the functions exposed in the DLL.

This tool uses Visual Studio's MSBuild for compilation and provides:

• Complete build output, including warnings and errors.
• Support for different configurations and platforms.
• Module definition file integration.
• Detailed build logs.

Export Analysis

analyze_exports

Analyze the exports of a compiled DLL using dumpbin.

• dllPath: Path to the DLL file (Required).

This analysis provides:

• A list of all exported functions.
• Export ordinals.
• Function names and addresses.
• Export forwarding information.
• Detailed export table analysis.

📋 Requirements

• Visual Studio 2022 Community Edition or higher.
• Visual C++ build tools.
• Windows SDK.

📦 Installation

1. Clone the repository:

git clone https://github.com/yourusername/cpp-builder-mcp-server.git
cd cpp-builder-mcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

⚙️ Configuration

Add the server to the MCP settings file:

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

💻 Usage Examples

Compile a DLL

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

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

Analyze DLL Exports

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

👨‍💻 Development

1. Modify the source code.
2. Run tests:

npm test

3. Build the project:

npm run build

🤝 Contribution

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a Pull Request.

📄 License

MIT