Server Management

Overview

MCPHub’s server management system allows you to centrally configure, monitor, and control multiple MCP (Model Context Protocol) servers from a single dashboard. All changes are applied in real-time without requiring server restarts.

Adding MCP Servers

Via Dashboard

Access the Dashboard: Navigate to http://localhost:3000 and log in
Click “Add Server”: Located in the servers section
Fill Server Details:
- Name: Unique identifier for the server
- Command: Executable command (e.g., npx, uvx, python)
- Arguments: Array of command arguments
- Environment Variables: Key-value pairs for environment setup
- Working Directory: Optional working directory for the command

Via Configuration File

Edit your mcp_settings.json file:

{
  "mcpServers": {
    "server-name": {
      "command": "command-to-run",
      "args": ["arg1", "arg2"],
      "env": {
        "API_KEY": "your-api-key",
        "CONFIG_VALUE": "some-value"
      },
      "cwd": "/optional/working/directory"
    }
  }
}

Via API

Use the REST API to add servers programmatically:

curl -X POST http://localhost:3000/api/servers \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "name": "fetch-server",
    "command": "uvx",
    "args": ["mcp-server-fetch"],
    "env": {}
  }'

Popular MCP Server Examples

Web Fetch Server

Provides web scraping and HTTP request capabilities:

{
  "fetch": {
    "command": "uvx",
    "args": ["mcp-server-fetch"]
  }
}

Available Tools:

fetch: Make HTTP requests
fetch_html: Scrape web pages
fetch_json: Get JSON data from APIs

Playwright Browser Automation

Browser automation for web interactions:

{
  "playwright": {
    "command": "npx",
    "args": ["@playwright/mcp@latest", "--headless"]
  }
}

Available Tools:

playwright_navigate: Navigate to web pages
playwright_screenshot: Take screenshots
playwright_click: Click elements
playwright_fill: Fill forms

File System Operations

File and directory management:

{
  "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"]
  }
}

Available Tools:

read_file: Read file contents
write_file: Write to files
create_directory: Create directories
list_directory: List directory contents

SQLite Database

Database operations:

{
  "sqlite": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-sqlite", "/path/to/database.db"]
  }
}

Available Tools:

execute_query: Execute SQL queries
describe_tables: Get table schemas
create_table: Create new tables

Slack Integration

Slack workspace integration:

{
  "slack": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-slack"],
    "env": {
      "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
      "SLACK_TEAM_ID": "T1234567890"
    }
  }
}

Available Tools:

send_slack_message: Send messages to channels
list_slack_channels: List available channels
get_slack_thread: Get thread messages

GitHub Integration

GitHub repository operations:

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token"
    }
  }
}

Available Tools:

create_or_update_file: Create/update repository files
search_repositories: Search GitHub repositories
create_issue: Create issues
create_pull_request: Create pull requests

Google Drive

Google Drive file operations:

{
  "gdrive": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-gdrive"],
    "env": {
      "GDRIVE_CLIENT_ID": "your-client-id",
      "GDRIVE_CLIENT_SECRET": "your-client-secret",
      "GDRIVE_REDIRECT_URI": "your-redirect-uri"
    }
  }
}

Available Tools:

gdrive_search: Search files and folders
gdrive_read: Read file contents
gdrive_create: Create new files

Amap Maps (China)

Chinese mapping and location services:

{
  "amap": {
    "command": "npx",
    "args": ["-y", "@amap/amap-maps-mcp-server"],
    "env": {
      "AMAP_MAPS_API_KEY": "your-api-key"
    }
  }
}

Available Tools:

search_location: Search for locations
get_directions: Get route directions
reverse_geocode: Convert coordinates to addresses

Server Lifecycle Management

Starting Servers

Servers are automatically started when:

MCPHub boots up
A server is added via the dashboard or API
A server configuration is updated
A stopped server is manually restarted

Stopping Servers

You can stop servers:

Via Dashboard: Toggle the server status switch
Via API: Send a POST request to /api/servers/{name}/toggle
Automatically: Servers stop if they crash or encounter errors

Restarting Servers

Servers are automatically restarted:

When configuration changes are made
After environment variable updates
When manually triggered via dashboard or API

Server Status Monitoring

Status Indicators

Each server displays a status indicator:

🟢 Running: Server is active and responding
🟡 Starting: Server is initializing
🔴 Stopped: Server is not running
⚠️ Error: Server encountered an error

Real-time Logs

View server logs in real-time:

Dashboard Logs: Click on a server to view its logs
API Logs: Access logs via /api/logs endpoint
Streaming Logs: Subscribe to log streams via WebSocket

Health Checks

MCPHub automatically performs health checks:

Initialization Check: Verifies server starts successfully
Tool Discovery: Confirms available tools are detected
Response Check: Tests server responsiveness
Resource Monitoring: Tracks CPU and memory usage

Configuration Management

Environment Variables

Servers can use environment variables for configuration:

{
  "server-name": {
    "command": "python",
    "args": ["server.py"],
    "env": {
      "API_KEY": "${YOUR_API_KEY}",
      "DEBUG": "true",
      "MAX_CONNECTIONS": "10"
    }
  }
}

Environment Variable Expansion:

${VAR_NAME}: Expands to environment variable value
${VAR_NAME:-default}: Uses default if variable not set
${VAR_NAME:+value}: Uses value if variable is set

Command Variations

Different ways to specify server commands:

{
  "npm-server": {
    "command": "npx",
    "args": ["-y", "package-name", "--option", "value"]
  }
}

Advanced Features

Hot Reloading

MCPHub supports hot reloading of server configurations:

Dashboard Updates: Immediately applies changes made through the web interface
API Updates: Real-time updates via REST API calls
Zero Downtime: Graceful server restarts without affecting other servers

Troubleshooting

Server Won't Start

Server Keeps Crashing

Tools Not Appearing

Next Steps

Group Management

Organize servers into logical groups

Smart Routing

Set up AI-powered tool discovery

API Reference

Server management API documentation

Configuration Guide

Detailed configuration options

Get Started

Core Features

Configuration

Overview

Adding MCP Servers

Via Dashboard

Via Configuration File

Via API

Popular MCP Server Examples

Server Lifecycle Management

Starting Servers

Stopping Servers

Restarting Servers

Server Status Monitoring

Status Indicators

Real-time Logs

Health Checks

Configuration Management

Environment Variables

Command Variations

Advanced Features

Hot Reloading

Troubleshooting

Next Steps

Group Management

Smart Routing

API Reference

Configuration Guide

Get Started

Core Features

Configuration

​Overview

​Adding MCP Servers

​Via Dashboard

​Via Configuration File

​Via API

​Popular MCP Server Examples

​Server Lifecycle Management

​Starting Servers

​Stopping Servers

​Restarting Servers

​Server Status Monitoring

​Status Indicators

​Real-time Logs

​Health Checks

​Configuration Management

​Environment Variables

​Command Variations

​Advanced Features

​Hot Reloading

​Troubleshooting

​Next Steps

Group Management

Smart Routing

API Reference

Configuration Guide

Overview

Adding MCP Servers

Via Dashboard

Via Configuration File

Via API

Popular MCP Server Examples

Server Lifecycle Management

Starting Servers

Stopping Servers

Restarting Servers

Server Status Monitoring

Status Indicators

Real-time Logs

Health Checks

Configuration Management

Environment Variables

Command Variations

Advanced Features

Hot Reloading

Troubleshooting

Next Steps