How To Pack Binary¶

This guide explains how to manually package and publish the official GitHub MCP server to UiPath Orchestrator. For automation, see the example GitHub Actions workflow.

Attention

To build binary MCP servers locally, your environment must match UiPath's serverless runtime architecture (Ubuntu 64-bit AMD64). On other operating systems, use the GitHub Actions workflow described in the Automating with GitHub Actions section below.

Prerequisites¶

UiPath Automation Cloud account
UiPath personal access token
go (version 1.21+)
python (version 3.11+)
uv package manager (pip install uv)

Steps¶

1. Clone and Build the GitHub MCP Server¶

# Clone the repositorygit clone https://github.com/github/github-mcp-server.gitcd github-mcp-server# Build the servercd cmd/github-mcp-servergo build

2. Create Package Directory¶

# Create package directory and copy executablemkdir -p mcp-packagecp github-mcp-server mcp-package/cd mcp-package

3. Create Configuration Files¶

Create the following files in the mcp-package directory:

mcp.json - Server configuration:

{
  "servers": {
    "github": {
      "command": "/bin/sh",
      "args": ["-c", "chmod +x github-mcp-server && ./github-mcp-server stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "x"
      }
    }
  }
}

pyproject.toml - Project metadata:

[project]
name = "mcp-github-server"
version = "0.0.1"
description = "Official GitHub MCP Server"
authors = [{ name = "John Doe" }]
dependencies = [
    "uipath-mcp>=0.0.99",
]
requires-python = ">=3.11"

4. Set Up Python Environment¶

# Initialize a new uv project in the current directoryuv venv# Activate the virtual environmentsource .venv/bin/activate# Install dependenciesuv sync

5. Authenticate With UiPath¶

uipath auth⠋ Authenticating with UiPath ...
🔗 If a browser window did not open, please open the following URL in your browser: [LINK]
👇 Select tenant:
0: Tenant1
1: Tenant2
Select tenant number: 0
Selected tenant: Tenant1
✓ Authentication successful.

6. Initialize UiPath Package¶

⠋ Initializing UiPath project ...
✓ Created '.env' file.
✓ Created 'uipath.json' file.

Edit the generated uipath.json to include the executable:

{
  "settings": {
    "filesIncluded": ["github-mcp-server"]
  }
}

7. Package for UiPath¶

⠋ Packaging project ...
Name : mcp-github-server
Version : 0.0.1
Description: Official GitHub MCP Server
Authors : John Doe
✓ Project successfully packaged.

8. Upload to UiPath Orchestrator¶

⠙ Publishing most recent package: mcp-github-server.0.0.1.nupkg ...
✓ Package published successfully!

Automating with GitHub Actions¶

To automate this process:

Copy the example workflow to .github/workflows/ in your repository.
Go to GitHub Actions tab and run the workflow.
Provide the version when prompted.
Download the artifact after completion.

The workflow handles all the manual steps automatically, including the crucial modification of uipath.json to include the executable in the package.