MCP Manager
A flexible Model Context Protocol (MCP) manager server that enables communication between AI models and tools. Compatible with Claude, MCP Dockmaster, and other MCP clients.
Features
- MCP Server Management: Run multiple MCP servers and manage them from a single interface
- Worker Mode: Operate as a worker for other MCP clients
- Auto-Discovery: Automatically find MCP servers on GitHub and from Smithery packages
- Tool Registry: Browse and install tools from a registry of MCP tools
- WebSocket Communication: JSON-RPC over WebSockets for real-time communication
- Headless Mode: Run in headless mode for API-first operation
Getting Started
Prerequisites
- Node.js (v18+)
- NPM (v8+)
Installation
# Clone the repository
git clone <your-repo-url>
cd <your-repo-directory>
# Install dependencies
npm install
# Create a .env file from the example
cp .env.example .env
# Edit .env to configure your MCP Manager
nano .env
Running the Server
# Run in development mode
npm run dev
# Build and run in production mode
npm run build
npm run start
Configuration Options
Configure your MCP Manager by editing the .env
file:
# Server Configuration
PORT=5000 # Main server port
HOST=0.0.0.0 # Host to bind to
NODE_ENV=development # Environment (development/production)
REUSE_PORT=true # Whether to reuse the port
# MCP Port Range
MCP_PORT_RANGE_START=50050 # Start port for MCP servers
MCP_PORT_RANGE_END=50150 # End port for MCP servers
# MCP Compatibility Settings
MCP_WORKER_MODE=false # Enable worker mode
MCP_DISCOVERY_ENABLED=true # Enable auto-discovery of MCP servers
MCP_AUTOSTART_SERVERS=true # Automatically start MCP servers
# Smithery API Configuration
SMITHERY_API_KEY=your_smithery_api_key_here # API key for Smithery packages
Using MCP Manager with Claude and Other MCP Clients
MCP Manager is designed to be compatible with various MCP clients, including:
- Claude Desktop
- MCP Dockmaster
- Toolbase
- Other MCP compatible clients
Connecting to Claude Desktop
- Run MCP Manager on your local machine
- Open Claude Desktop
- Go to Settings > Advanced > MCP Configuration
- Set the MCP Server URL to
http://localhost:5000/ws
- MCP Manager will appear as an available server in Claude
Connecting to MCP Dockmaster
- Run MCP Manager on your local machine
- Open MCP Dockmaster
- Click “Add Server”
- Enter the server information:
- Name: MCP Manager
- Address: localhost
- Port: 5000
- Click “Connect”
Using Worker Mode
MCP Manager can operate as a worker for other MCP clients:
- Set
MCP_WORKER_MODE=true
in your.env
file - Run MCP Manager
- Connect to MCP Manager from your MCP client
- MCP Manager will automatically discover and register available tools
Headless/API-First Operation
MCP Manager supports headless operation for API-first clients:
GET /?api_key=YOUR_API_KEY&headless=true&auto_connect=true
Query parameters:
api_key
: Your API key (if required)headless
: Enable headless modeauto_connect
: Automatically connect to available MCP serversws_url
: Specify a custom WebSocket URLserver_id
: Connect to a specific server ID
API Reference
MCP Manager implements the JSON-RPC protocol over WebSockets. The main API endpoint is:
ws://localhost:5000/ws
Available Methods
ping
: Test server connectivitygetServers
: Get all registered serversgetServer
: Get server by IDtoggleWorker
: Toggle worker status for a servergetTools
: Get all toolsgetToolsByServer
: Get tools for a specific serveractivateTool
: Activate a tooldeactivateTool
: Deactivate a toolgetStats
: Get server statistics
License
MIT
MCP Manager
Project Details
- samihalawa/2025-FINAL-mcpMaster
- rest-express
- Last Updated: 4/3/2025
Recomended MCP Servers
Runbook MCP Server
MCP server for Tembo Cloud's platform API
Zerodha Kite Connect MCP Server
MCP server that provides tools and resources for integrating Hugeicons into various platforms. It implements a Model Context...
影刀RPA MCP Server
Damn Vulnerable MCP Server
为 Cursor、Windsurf、Cline 和其他 AI 驱动的编码工具提供访问飞书文档的能力,基于 Model Context Protocol 服务器实现。
A Model Context Protocol (MCP) server that provides file system context to Large Language Models (LLMs). This server...
A Model Context Protocol (MCP) server that integrates with Google's Gemini Pro model, can be used in Claude...
基于MCP(Model Context Protocol)协议的飞书项目管理工具
It adds eyes, ears, and a mouth to the large model!基于多智能体架构的人机交互系统,集成了视觉识别、语音识别和语音合成等功能。系统由多个专门的智能体协同工作,实现了自然的人机交互体验。给大模型增加眼睛和耳朵和嘴巴!
A python repl for MCP