getting-started/installation
Installation
Installing MCPFlo on macOS or Windows, and building from source.
Requirements
- macOS (Apple Silicon / arm64 only) or Windows
- ~200 MB disk space
macOS (.dmg)
- Download the latest
.dmgfrom the GitHub releases page. - Open the
.dmgand drag MCPFlo into your Applications folder. - Launch it from Applications (or Spotlight).
macOS builds are signed with an Apple Developer ID and notarized, so the app opens without any Gatekeeper warnings.
Upgrading from v0.0.6 or earlier? Those builds were unsigned. Delete the old copy and install fresh from the latest release — the right-click → Open workaround is no longer needed.
Windows
Download the latest installer (.exe, NSIS) from the
releases page.
Note: Windows builds are currently unsigned. Windows SmartScreen may show a “Windows protected your PC” warning when you run the installer. Click More info → Run anyway to proceed. This is expected and not a sign of a corrupted download — signing for Windows builds is planned but not yet in place.
Building from source
Requires Node.js 18+ and npm 9+.
git clone https://github.com/harshalslimaye/mcpflo.git
cd mcpflo
npm install
npm run dev
To produce a packaged build for a specific platform:
npm run build:mac # macOS (dmg, arm64)
npm run build:win # Windows (nsis, x64 + arm64)
npm run build:linux # Linux
Linux is buildable from source but doesn’t currently have official pre-built releases — use
npm run build:linuxto produce your own package.