McpManager

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 16 Open GitHub ↗

A self-hosted MCP proxy and aggregation platform. Manage multiple MCP servers and expose them through a single endpoint.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MCP Manager

**A self-hosted MCP proxy and aggregation platform.**

Manage multiple upstream MCP (Model Context Protocol) servers, sync their tools, and expose them through a single unified MCP endpoint. Connect once, access everything.

[![CI](https://github.com/daniel3303/McpManager/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/daniel3303/McpManager/actions/workflows/ci.yml)
[![CodeQL](https://github.com/daniel3303/McpManager/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/daniel3303/McpManager/actions/workflows/codeql.yml)
[![codecov](https://codecov.io/github/daniel3303/McpManager/graph/badge.svg?branch=main)](https://codecov.io/github/daniel3303/McpManager)
[![Docker Image Version](https://img.shields.io/docker/v/daniel3303/mcpmanager?logo=docker&label=docker&sort=semver)](https://hub.docker.com/r/daniel3303/mcpmanager)
[![Docker Pulls](https://img.shields.io/docker/pulls/daniel3303/mcpmanager?logo=docker)](https://hub.docker.com/r/daniel3303/mcpmanager)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/daniel3303/McpManager/main/LICENSE)
[![Release](https://img.shields.io/github/v/release/daniel3303/McpManager?logo=github&display_name=tag)](https://github.com/daniel3303/McpManager/releases)
![AI Agents](https://img.shields.io/badge/AI_Agents-Ready-FF6F00)
![LLM Tools](https://img.shields.io/badge/LLM_Tools-Gateway-8A2BE2)
![.NET 10](https://img.shields.io/badge/.NET-10.0-512BD4?logo=dotnet)
![MCP](https://img.shields.io/badge/MCP-v0.6-blue)
![SQLite](https://img.shields.io/badge/SQLite-Database-003B57?logo=sqlite)
![Self-Hosted](https://img.shields.io/badge/Self--Hosted-Yes-green)

---

## Quick Start

```bash
docker run -p 5057:8080 -v mcpmanager-data:/app/data daniel3303/mcpmanager:latest
```

Open [http://localhost:5057](http://localhost:5057) and sign in with the default admin account:

- **Email:** `admin@mcpmanager.local`
- **Password:** `123456`

> Change the password immediately after first login from the user menu → **Change Password**.

---

## What is MCP Manager?

MCP Manager sits between your AI tools (Claude Code, Cursor, Windsurf, etc.) and your MCP servers. Instead of configuring each server individually in every client, you register them once in MCP Manager and connect your clients to a single endpoint.

## Key Features

### Unified MCP Proxy
Aggregate tools from all registered upstream MCP servers into a single `/mcp` endpoint. Connect your AI clients once and access every tool from every server — no per-server configuration needed.

### Multi-Transport Support
Connect to remote servers via HTTP/SSE, run local CLI tools via Stdio, or auto-convert REST APIs from OpenAPI specs. Each transport supports its own authentication methods (Bearer, API key, Basic auth, environment variables).

### Namespace Organization
Group MCP servers into logical namespaces with slug-based routing (e.g., `/mcp/namespaces/my-namespace`). Each namespace has independent rate limiting, API key scoping, and per-tool configuration.

### Tool Customization & Control
Override tool names, descriptions, and parameter schemas per server or per namespace. Enable or disable individual tools so the same server can expose different tool sets in different namespaces.

### Health Checks & Notifications
Automatic connectivity checks verify each server is reachable via its configured transport. When a server goes down, all active users receive in-app notifications.

### Rate Limiting
Per-namespace rate limiting with three strategies: PerApiKey (limit per unique key), PerIp (limit by client IP), or Global (single namespace-wide limit). Configure requests-per-minute thresholds independently for each namespace.

### Interactive Playground
Test and execute MCP tools directly from the browser. The playground dynamically builds input forms from each tool's JSON schema, including type-aware fields for enums, numbers, and nested objects.

### API Key Management
Generate scoped API keys (prefixed `mcpm_`) with optional namespace restrictions. Keys are used as Bearer tokens for authenticating MCP client connections and are tracked per-request for auditing.

### Import from Config
Import server configurations from Claude Desktop, Cursor, or Opencode JSON formats. Existing servers are detected and skipped automatically, with a summary of imported, skipped, and errored entries.

### OpenAPI-to-MCP
Point MCP Manager at any OpenAPI 3.x spec (JSON or YAML) and it automatically converts each operation into a callable MCP tool. Path, query, and body parameters are mapped to tool input schemas.

### Request Logging & Live Streaming
Every tool execution is recorded with parameters, response, success status, and execution time. A real-time log viewer streams entries with filters for server, log level, and time range.

### User Management
Multi-user support with ASP.NET Identity. Claims-based authorization controls access to features like server management, API keys, and the playground. Admins can create users, reset passwords, and manage permissions.

## Screenshots

| | |
|---|---|
| ![Dashboard](https://raw.githubusercontent.com/daniel3303/McpManager/main/docs/screenshots/dashboard.png) **Dashboard** — Overview of servers, tools, and API keys | ![MCP Servers](https://raw.githubusercontent.com/daniel3303/McpManager/main/docs/screenshots/mcp-servers.png) **Servers** — Manage upstream MCP servers |
| ![Create Server](https://raw.githubusercontent.com/daniel3303/McpManager/main/docs/screenshots/mcp-server-create.png) **Create Server** — Add servers with multi-transport support | ![Playground](https://raw.githubusercontent.com/daniel3303/McpManager/main/docs/screenshots/mcp-playground.png) **Playground** — Execute tools interactively |

## Getting Started

### Docker

```bash
docker run -p 5057:8080 -v mcpmanager-data:/app/data daniel3303/mcpmanager:latest
```

The SQLite database and logs are stored in `/app/data`. Sign in with the default admin account shown in the [Quick Start](#quick-start) and change the password immediately.

#### Host Network Mode

If you need MCP Manager to connect to MCP servers running on the host machine (e.g., Stdio servers or services on `localhost`), use host networking:

```bash
docker run --network host -v mcpmanager-data:/app/data daniel3303/mcpmanager:latest
```

With `--network host` the container shares the host's network stack directly, so MCP Manager listens on port `8080` and can reach any local service. The `-p` flag is not needed in this mode.

> **Note:** Host network mode is only supported on Linux. On macOS and Windows (Docker Desktop), use `host.docker.internal` instead of `localhost` to reach host services.

### Run Locally

#### Prerequisites

- [.NET 10 SDK](https://dotnet.microsoft.com/download)
- [Node.js](https://nodejs.org/) (for frontend build)

```bash
# Clone the repository
git clone https://github.com/daniel3303/McpManager.git
cd McpManager

# Build the frontend
cd src/McpManager.Web.Portal && npm install && npx vite build && cd ../..

# Run the application
dotnet run --project src/McpManager.Web.Portal
```

The app will be available at `http://localhost:5057`. Sign in with the default admin account shown in the [Quick Start](#quick-start) and change the password immediately.

## Connecting Your AI Tools

Once MCP Manager is running, connect your AI tools to the unified endpoint:

```jsonc
// Example: Claude Code, Cursor, Windsurf, etc.
{
  "mcpServers": {
    "mcpmanager": {
      "url": "http://localhost:5057/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

Generate API keys from the **API Keys** page in the admin panel.

## Configuration

### Transport Types

| Transport | Description | Auth Options |
|-----------|-------------|--------------|
| **HTTP** | Connect to remote MCP servers via HTTP/SSE | Bearer token, API key, Basic auth |
| **Stdio** | Run local MCP servers as CLI processes | Environment variables |
| **OpenAPI** | Auto-convert OpenAPI specs to MCP tools | Bearer token, API key, Basic auth |

## Tech Stack

- **Backend**: .NET 10, ASP.NET Core, EF Core, SQLite
- **Frontend**: Tailwind CSS, DaisyUI, Vite, jQuery
- **MCP SDK**: ModelContextProtocol v0.6.0-preview.1
- **Auth**: ASP.NET Identity
- **Logging**: Serilog (console + rolling file)

## License

MIT

## Author

Daniel Oliveira

[![Website](https://img.shields.io/badge/Website-FF6B6B?style=for-the-badge&logo=safari&logoColor=white)](https://danielapoliveira.com/)
[![X](https://img.shields.io/badge/X-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/daniel_not_nerd)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/daniel-ap-oliveira/)

McpManager

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README