convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
kakehashi-inc

MCP Server Manager

kakehashi-inc/mcp_server_manager

GUI Electron para controlar, monitorar e expor servidores MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Aplicação desktop em Electron para gerenciar servidores MCP com inicialização, parada, monitoramento de logs e exposição via ngrok. Inclui proxy HTTPS com certificados auto-gerados, suporte a WSL no Windows e autenticação OIDC opcional.

Instalação

$npx convez-ai kakehashi-inc/mcp_server_manager

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 2 semanas
Versão
v0.4.2
Issues abertas
0
Contribuidores
1

Casos de uso

  • Iniciar/parar múltiplos servidores MCP sem linha de comando
  • Expor servidores locais na internet via ngrok com gerenciamento centralizado
  • Executar servidores MCP dentro de WSL no Windows
  • Gerenciar logs diários de processos com limpeza automática
  • Adicionar autenticação OIDC a servidores MCP via proxy

Veredito

Ferramenta robusta e bem-pensada para operacionalizar servidores MCP em produção. Resolve problemas práticos reais (ngrok, HTTPS, logs, WSL) com uma interface intuitiva, embora exija instalação e configuração inicial.

README

A tradução para o português deste README ainda está na fila.

MCP Server Manager

Electron-based GUI application to start/stop, monitor, log, and expose (via ngrok) MCP servers.

Features

  • Process Management: Register arbitrary MCP server commands, start/stop, status monitoring, error handling
  • Auto Start / Auto Restart: Start on app launch, conditional auto-restart on abnormal exit
  • WSL Support (Windows): Run inside WSL with selectable distribution (platform: "wsl")
  • Log Management: Per-process daily log files for stdout/stderr, auto-clean by retention days, periodic rotation
  • ngrok Integration: Open multiple ports at once, show/copy URLs, view/clear ngrok logs
  • HTTPS Proxy Management: Terminate TLS locally and forward to local HTTP, per-day logs, self-signed cert auto-(re)generation
  • Auth Proxy (Optional): Wrap with mcp-auth-proxy to add OIDC authentication
  • i18n/Theme: Japanese/English, light/dark modes

Supported OS

  • Windows 10/11
  • macOS 10.15+
  • Linux (Debian-based/RHEL-based)

Note: This project is not code-signed on Windows. If SmartScreen displays a warning, select "More info" → "Run anyway".

Data Files Location

All data is stored under the ~/.mcpm directory:

  • Config File: ~/.mcpm/config.json
  • Log Files: ~/.mcpm/logs/
    • Process logs: {server_id}_YYYYMMDD_stdout.log, {server_id}_YYYYMMDD_stderr.log
    • ngrok logs: ngrok_YYYYMMDD.log
    • HTTPS proxy logs: https_proxy_YYYYMMDD.log

File Structure

~/.mcpm/
├── config.json      # Settings and MCP server definitions
├── certs/           # Self-signed certificates per hostname for HTTPS proxy
│   └── <hostname>/
│       ├── cert.pem
│       └── key.pem
└── logs/            # Log files
    ├── {server_id}_YYYYMMDD_stdout.log
    ├── {server_id}_YYYYMMDD_stderr.log
    ├── ngrok_YYYYMMDD.log
    └── https_proxy_YYYYMMDD.log

config.json Format

Configuration file generated based on the app's default DEFAULT_CONFIG:

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"],
      "env": {
        "NODE_ENV": "production"
      },
      "displayName": "Sequential Thinking Server",
      "platform": "host",
      "autoStart": true,
      "autoRestartOnError": true,
      "useAuthProxy": false
    },
    "file-server": {
      "command": "python",
      "args": ["mcp_server.py"],
      "displayName": "File Server",
      "platform": "wsl",
      "wslDistribution": "Ubuntu",
      "autoStart": false
    }
  },
  "settings": {
    "language": "ja",
    "darkMode": false,
    "logDirectory": "~/.mcpm/logs",
    "logRetentionDays": 7,
    "restartDelayMs": 5000,
    "successfulStartThresholdMs": 10000,
    "showWindowOnStartup": true,
    "ngrokAuthToken": "",
    "ngrokMetadataName": "MCP Server Manager",
    "ngrokPorts": "3000,4000",
    "ngrokAutoStart": false,
    "httpsProxies": {
      "example.local": {
        "forwardPort": 8080,
        "listenPort": 8443,
        "autoStart": true
      }
    },
    "oidcProviderName": "Auth0",
    "oidcConfigurationUrl": "",
    "oidcClientId": "",
    "oidcClientSecret": "",
    "oidcAllowedUsers": "",
    "oidcAllowedUsersGlob": ""
  }
}

MCP Server Configuration Fields

  • command: Executable command
  • args: Argument array
  • env: Environment variables
  • displayName: Display name
  • platform: Execution environment ("host" | "wsl")
  • wslDistribution: WSL distribution name (when using WSL)
  • autoStart: Auto-start on app launch
  • autoRestartOnError: Auto-restart on abnormal exit (conditional)
  • useAuthProxy: Wrap execution with mcp-auth-proxy
  • authProxyListenPort / authProxyExternalUrl: Required fields when using Auth Proxy

Developer Reference

Requirements

  • Node.js 22.x or higher
  • yarn 4
  • Git

Installation

# Clone the repository
git clone <repository-url>
cd <repository-name>

# Install dependencies
yarn install

# Start development
yarn dev

DevTools in development:

  • DevTools open in detached mode automatically
  • Toggle with F12 or Ctrl+Shift+I (Cmd+Option+I on macOS)

Build/Distribute

  • Windows: yarn dist:win
  • macOS: yarn dist:mac
  • Linux: yarn dist:linux

In development the app uses BrowserRouter with <http://localhost:3001>, and in production it uses HashRouter to load dist/renderer/index.html.

Direct Release to GitHub (for Auto-Update)

These commands directly upload the build artifacts and latest*.yml (auto-update metadata) to the GitHub repository configured in publish: of electron-builder.yml. Because of the releaseType: draft setting, each command aggregates into the same draft release for that version on GitHub. Once all platforms are in place, press "Publish release" in the GitHub UI to deliver it to users.

  • Windows: yarn release:win
  • macOS: yarn release:mac
  • Linux: yarn release:linux

Before running, set a GitHub Personal Access Token (public_repo scope) in the GH_TOKEN environment variable.

export GH_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxx"

When building each platform on multiple machines, make sure the version in package.json matches across all machines, then run the corresponding release:* command on each machine in turn.

macOS Prerequisite: Signing & Notarization Environment Variables

To build a signed and notarized macOS distribution, set the following environment variables before running yarn dist:mac:

export APPLE_ID="your-apple-id@example.com"
export APPLE_APP_SPECIFIC_PASSWORD="xxxx-xxxx-xxxx-xxxx"
export APPLE_TEAM_ID="XXXXXXXXXX"

Windows Prerequisite: Developer Mode

When building or running unsigned local releases on Windows, enable Developer Mode:

  1. Open Settings → Privacy & security → For developers
  2. Turn on "Developer Mode"
  3. Reboot the OS

Project Structure (excerpt)

src/
├── main/                  # Electron main: IPC and managers
│   ├── index.ts           # App boot / window / service init
│   ├── ipc/               # IPC handlers
│   ├── services/          # Various services
│   └── utils/             # Various utilities
├── preload/               # Safe bridge APIs to renderer
├── renderer/              # React + MUI UI
├── shared/                # Types and constants (defaults/paths)
└── public/                # Icons, etc.

Tech Stack

  • Electron
  • React (MUI v7)
  • TypeScript
  • Zustand
  • i18next
  • Vite

Create Windows Icon

magick public/icon.png -define icon:auto-resize=256,128,96,64,48,32,24,16 public/icon.ico

About WSL (Windows)

  • On startup, the app detects WSL availability and retrieves the distribution list, default, and running states using wsl.exe -l -q/-v

Notes

  • ngrok may fail to start when hitting the concurrent session limit. Disconnect unnecessary sessions from CLI/Desktop or the Agents section in the dashboard.
  • Closing with "×" minimizes the app to the tray instead of quitting. Use "Quit" from the tray menu to exit.
Ver o original no GitHub

Bom para

Relacionados