Overview

MCPHub is an open-source desktop application for macOS and Windows that simplifies discovering, installing, configuring, and running MCP (Model Context Protocol) server instances. It provides a graphical interface to manage one or many MCP server instances locally, making it easier for developers, researchers, and QA engineers to work with model-serving endpoints without relying entirely on command-line tooling.

The app focuses on three common pain points: finding compatible MCP servers or distributions, creating and managing instance configurations (ports, paths, environment variables), and observing runtime state (logs, process status, health). MCPHub is intended as a lightweight control plane for local development and testing of MCP-compatible servers.

Features

Cross-platform GUI for macOS and Windows
Discover and add MCP server instances from local folders or remote packages
Install and update server distributions (via local archive or URL)
Start, stop, restart, and monitor instances from the UI
View real-time logs and process output
Edit instance configuration (port, environment, arguments)
Health checks and basic metrics (uptime, PID, port)
Export/import instance definitions (JSON)
Minimal dependency on CLI — integrates with existing local runtimes

Installation / Configuration

Prebuilt binaries are provided on the project GitHub releases page. For the latest source or to build locally, clone the repository and use Node.js tooling.

Download a release (recommended)

macOS: DMG or ZIP
Windows: EXE or ZIP

Build from source (macOS / Windows)

# clone repository
git clone https://github.com/Jeamee/MCPHub-Desktop.git
cd MCPHub-Desktop

# install dependencies (Node.js and npm/yarn required)
npm install

# run in development mode
npm run dev

# build production package (platform-specific)
npm run build

Configuration: instance definitions are stored per-user in JSON files. A simple instance definition looks like:

{
  "name": "local-mcp-server",
  "path": "/path/to/mcp-server",
  "port": 8080,
  "env": {
    "MCP_MODE": "dev"
  },
  "args": ["--config", "config.yml"]
}

Use the GUI to create or import these definitions. The app validates port conflicts and basic health endpoints before launching.

Available Resources

GitHub repository (source, issues, releases): https://github.com/Jeamee/MCPHub-Desktop
Instance export/import (JSON)
Built-in log viewer (live streaming)
Simple health checks (HTTP ping)
Configuration editor inside the app

Platform support summary:

Platform	Distribution formats
macOS	DMG / ZIP
Windows	EXE / ZIP

Use Cases

Local development and iteration
- Run a local MCP server instance while developing an adapter or model context. Use the GUI to start/stop the server, view logs, and tweak environment variables without reopening a terminal.
Testing multiple server versions
- Maintain separate instance definitions for different server versions or configurations (e.g., v1.0 vs v2.0). Launch them in parallel on different ports to run integration tests against each variant.
QA and demo environments
- Rapidly create disposable instances for demos or QA scenarios. Export an instance definition to share a reproducible environment with colleagues.
Onboarding and education
- For teams new to the Model Context Protocol, give non-CLI users (designers, product managers) a simple way to explore MCP servers and their behavior.

Troubleshooting & Tips

If an instance fails to start, open the log viewer first — most errors (missing executable, port in use, configuration errors) appear there.
Use the import/export feature to version instance configurations alongside your codebase.
When building from source, ensure Node.js and your platform-specific build tools are installed (macOS: Xcode command line tools; Windows: suitable build chain).

For bugs, feature requests, or to download releases, visit the project repository: https://github.com/Jeamee/MCPHub-Desktop.

MCPHub MCP Server GUI for macOS and Windows