Setting Up the MCP Server
This guide shows you how to connect the Paquet Builder MCP server to your preferred AI coding assistant.
How to Obtain the MCP Server
Section titled “How to Obtain the MCP Server”The MCP server is a free add-on for all Paquet Builder editions (Freeware, Trial, Pro, and Ultimate).
Installation
Section titled “Installation”-
Install Paquet Builder (GUI) on the target computer.
-
Download the MCP server — In Paquet Builder, go to Help → Check for Updates & Addons to download the MCP server installer. You can also download it directly from the MCP Server download page.
-
Run the MCP server installer. It will install
PBMCPServer.exeinto the Paquet Builder installation folder.
The MCP server is now ready to use by AI clients.
Configuration
Section titled “Configuration”Add the following to your project’s .mcp.json file or to Claude Code’s global MCP settings:
{ "mcpServers": { "pbmcpserver": { "type": "stdio", "command": "C:\\Program Files\\Paquet Builder\\PBMCPServer.exe", "args": [] } }}In Cursor, open the MCP settings (Settings → MCP Servers) and add a new server:
{ "mcpServers": { "paquet-builder": { "command": "C:\\Program Files\\Paquet Builder\\PBMCPServer.exe", "args": [] } }}In Windsurf’s MCP configuration:
{ "mcpServers": { "paquet-builder": { "command": "C:\\Program Files\\Paquet Builder\\PBMCPServer.exe", "args": [] } }}The MCP server uses the stdio transport — it communicates via standard input and output using newline-delimited JSON-RPC 2.0 messages with UTF-8 encoding.
To integrate with any MCP client:
-
Start
PBMCPServer.exeas a child process -
Send JSON-RPC requests to its stdin
-
Read JSON-RPC responses from its stdout
Verifying the Connection
Section titled “Verifying the Connection”Once configured, your AI client should be able to list the available Paquet Builder tools. Try asking:
“List the available Paquet Builder tools”
Or open a project:
“Open the project at C:\MyProject\installer.pbpx”
If the MCP server is correctly configured, the AI will use the open_project tool and report the project details.
Typical Workflow
Section titled “Typical Workflow”A typical MCP session follows this pattern:
-
Open a project —
open_projectwith the path to a .pbpx file -
Query current state —
get_project_info,get_setting,collection_query -
Make modifications —
set_setting,collection_mutate,custom_actions_mutate -
Compile —
compile, thenget_build_logto check results -
Close —
close_project
Example: Creating an Installer with Claude Code
Section titled “Example: Creating an Installer with Claude Code”Here’s an example conversation with Claude Code using the MCP server:
You: Open my project at D:\Projects\myapp.pbpx and show me its current settings
Claude Code: Uses
open_projectandget_project_info— Your project “My Application” targets x64, uses LZMA2 compression with ultra level. Output: D:\Output\Setup.exe. 3 components, 142 files. Not signed.
You: Enable code signing with SHA-256 and sign the uninstaller too
Claude Code: Uses
set_settingfordigitalsign,signmethod, andcsignuninst— Done. Digital signing is now enabled with SHA-256. The uninstaller will also be signed.
You: Now compile it and check for errors
Claude Code: Uses
compilethenget_build_log— Build completed successfully. Output: D:\Output\Setup.exe (12.4 MB). No errors, 0 warnings.
Protocol Details
Section titled “Protocol Details”| Property | Value |
|---|---|
| Protocol | MCP 2025-03-26 |
| Transport | stdio (standard input/output) |
| Message format | Newline-delimited JSON-RPC 2.0 |
| Encoding | UTF-8 |
Troubleshooting
Section titled “Troubleshooting””Server not found” or “Connection failed”
Section titled “”Server not found” or “Connection failed””- Verify that
PBMCPServer.exeexists at the configured path - Check that the path uses double backslashes in JSON:
C:\\Program Files\\... - Ensure Paquet Builder is installed in the same directory as
PBMCPServer.exe. The MCP server works with all editions — if no license is found, it runs in Trial mode
Tools not responding
Section titled “Tools not responding”- The MCP server loads the full Paquet Builder engine on startup, which may take a few seconds
- Check that no other instance of PBMCPServer.exe is already running
Build errors
Section titled “Build errors”- Use
get_build_logaftercompileto see detailed error messages - Ensure all source files referenced by the project are accessible from the build machine