Peterparker57 Cpp Builder MCP Server

🚀 C++ Builder MCP Server

A MCP server that provides C++ DLL compilation and analysis capabilities. This server can use Visual Studio build tools to compile C++ DLLs with specific export settings and analyze DLL exports via dumpbin.

🚀 Quick Start

This C++ Builder MCP Server offers compilation and analysis features for C++ DLLs. You can quickly get started by following the installation and configuration steps below.

✨ Features

• Compile C++ DLLs using MSBuild.
• Configure custom export settings through .def files.
• Analyze DLL exports using dumpbin.
• Configurable build settings.
• Platform and configuration target setting.
• 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 for the export file (optional).
  • Specify exported functions and their attributes.
  • Used to 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 via 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 your MCP settings file:

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

💻 Usage Examples

Basic Usage

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

Advanced Usage

// 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 Steps

1. Make modifications to the source code.
2. Run tests:

npm test

3. Build the project:

npm run build

🤝 Contribution Guidelines

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