Skip to main content

Introduction

Welcome to MCP Gatekeeper documentation!

MCP Gatekeeper is a local Python daemon with React + TypeScript Web UI for managing MCP (Model Context Protocol) servers with comprehensive monitoring and telemetry.

What is MCP Gatekeeper?​

MCP Gatekeeper provides a centralized solution for:

  • Managing MCP Servers: Install, configure, and monitor MCP server packages
  • Agent Integration: Seamlessly integrate with AI agents like Claude Desktop and Windsurf
  • Real-time Monitoring: Track server performance, metrics, and logs in real-time
  • Developer Experience: Beautiful web interface with dark/light themes and intuitive UX

Key Features​

  • 📦 Package Management: Install and manage MCP server packages from npm registry
  • 🤖 Agent Configuration: Manage MCP server configurations for Claude Desktop, Windsurf, and other AI agents
  • 📊 Real-time Monitoring: Live WebSocket updates for metrics, logs, and tool call events
  • 🔍 Server Activity Tracking: Individual server activity monitoring with detailed logs and metrics
  • 📈 Metrics & Analytics: Track tool-call counts, errors, latency, and performance statistics
  • 🔐 Authentication: Token-based authentication with X-MCPGK-Token header
  • 🔌 MCP Client Integration: JSON-RPC client for querying MCP server tools and capabilities
  • 📝 Integrated Logging: Dedicated log viewer with filtering, search, and terminal-style interface
  • 🎨 Modern Web UI: React + TypeScript + Material-UI interface with Dark/Light theme support

Architecture​

MCP Gatekeeper is built as a Turborepo monorepo with two main workspaces:

  • Backend (apps/backend/): FastAPI Python daemon that binds to 127.0.0.1 for local-only access
  • Frontend (apps/frontend/): React + Vite + TypeScript Web UI with Material-UI components

Get Started​

Ready to dive in? Head over to the Installation Guide to get MCP Gatekeeper up and running on your system.