Setup

Prerequisites

• macOS 12+ (verify with: sw_vers -productVersion)
• Swift 6.2+ (verify with: swift --version)
• GitHub App with repository read permissions

Verification

After building, confirm the binary was created:

ls -la .build/arm64-apple-macosx/debug/MCPGitHubOrgMapper

Inspect the binary's load commands:

otool -l .build/arm64-apple-macosx/debug/MCPGitHubOrgMapper

To verify the minimum macOS version specifically:

otool -l .build/arm64-apple-macosx/debug/MCPGitHubOrgMapper | grep -A 5 LC_BUILD_VERSION

Should show minos 12.0 confirming macOS 12.0 minimum.

GitHub App Setup

1. Install the harpertoken-mcp GitHub App in your organization
2. Note the App ID and Installation ID from the app settings
3. Download the private key from the app settings

Local Setup

git clone https://github.com/harpertoken/mcp-org.git
cd mcp-org
swift build

Configuration

Copy .env.example to .env and fill in credentials:

cp .env.example .env
# Edit .env with your values

Run test:

swift run MCPGitHubOrgMapper