Skip to content

AlecPapierniak/mcp-manager

Repository files navigation

MCP Server Manager

A web UI for managing MCP (Model Context Protocol) server configurations across your AI coding agent projects.

What it does

MCP servers extend AI coding agents with additional capabilities—file system access, database connections, API integrations, and more. Each project you work on may need different MCP servers enabled or disabled.

This tool provides a single interface to:

  • View all projects that have MCP server configurations
  • Enable/disable individual MCP servers per project
  • Add new MCP servers to one or multiple projects
  • Clone MCP server configurations from one project to others
  • Search and filter projects

Supported Agents

Agent Status Config Location
Claude Code Supported ~/.claude.json
Gemini Coming soon
Codex Coming soon

Installation

Requires Node.js 20+.

Run once with npx

npx @alecpapierniak/mcp-manager@latest

This downloads and starts the server. Open http://localhost:33239 in your browser.

Install globally

npm install -g @alecpapierniak/mcp-manager

Then run it anytime:

mcp-manager

Run from source

git clone https://github.com/AlecPapierniak/mcp-manager.git
cd mcp-manager
npm install
npm run dev

How it works

The app reads and writes directly to your agent's configuration file (e.g., ~/.claude.json for Claude Code). Changes are applied immediately—no restart of your coding agent required.

The configuration file structure follows each agent's native format. For Claude Code, this means the projects object with mcpServers and disabledMcpServers arrays.

Development

npm run dev       # Start dev server
npm run build     # Production build
npm run e2e       # Run Playwright tests

License

GPL-3.0

About

Simple, local-only tool for managing local MCP servers

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors