MCPdog

v1.0.0โ€ขDeveloper Toolsโ€ขstable

๐Ÿ• Universal MCP Server Manager - Configure once, manage multiple MCP servers through a single interface. Perfect for Claude Desktop, Claude Code, Cursor, Gemini CLI & AI assistants. Web dashboard, auto-detection, unified proxy layer.

ai-assistantclaudecursormcpmodel-context-protocol
Share:
18
Stars
0
Downloads
0
Weekly
0/5

What is MCPdog?

MCPdog is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐Ÿ• universal mcp server manager - configure once, manage multiple mcp servers through a single interface. perfect for claude desktop, claude code, cursor, gemini cli & ai assistants. web dashboard, au...

๐Ÿ• Universal MCP Server Manager - Configure once, manage multiple MCP servers through a single interface. Perfect for Claude Desktop, Claude Code, Cursor, Gemini CLI & AI assistants. Web dashboard, auto-detection, unified proxy layer.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ๐Ÿ• Universal MCP Server Manager - Configure once, manage mult

Use Cases

Configure and manage multiple MCP servers through unified interface. Access MCP servers via web dashboard and CLI. Auto-detect and manage MCP servers across AI assistants.
kinhunt

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedApr 8, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcpdog

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCPdog

MCPdog is a universal MCP server manager that acts as a single proxy layer between your AI clients and all your configured MCP servers. Instead of copy-pasting server configurations into every AI tool you use, you configure servers once in MCPdog and then point Claude Desktop, Cursor, Gemini CLI, or any other MCP client to the single MCPdog endpoint. It provides a web dashboard at localhost:38881 for managing servers, viewing live logs, and monitoring tool health, and supports stdio, streamable-HTTP, and SSE transports.

Prerequisites

  • Node.js 18 or later
  • An MCP-enabled client such as Claude Desktop, Cursor, or Gemini CLI
  • Optional: Docker for containerized deployment
  • Optional: MCPDOG_AUTH_TOKEN environment variable for cloud/remote deployments
1

Add MCPdog to your MCP client configuration

Add the mcpdog entry to your client config. MCPdog itself is installed on demand via npx. All other MCP servers you want to use will be managed through MCPdog's own config file.

{
  "mcpServers": {
    "mcpdog": {
      "command": "npx",
      "args": ["mcpdog@latest"]
    }
  }
}
2

Restart your MCP client

Restart Claude Desktop or your chosen client. MCPdog will start and create its config file at ~/.mcpdog/mcpdog.config.json on first run.

3

Add MCP servers to MCPdog

Use the MCPdog CLI to add the MCP servers you want managed. The --auto-detect flag probes the server to discover its transport type automatically.

# Add a stdio-based server
npx mcpdog@latest config add my-server "npx @some/mcp-server@latest" --auto-detect

# Add an HTTP server
npx mcpdog@latest config add api-server https://api.example.com --transport streamable-http

# List configured servers
npx mcpdog@latest config list
4

Open the web dashboard

Navigate to the MCPdog dashboard in your browser to monitor server status, view logs, and manage tools graphically.

http://localhost:38881
5

Optional: remove a server

Remove a server from the MCPdog managed pool when it is no longer needed.

npx mcpdog@latest config remove old-server

MCPdog Examples

Client configuration

Minimal claude_desktop_config.json that hands all MCP server routing to MCPdog. Add your actual servers via the MCPdog CLI or dashboard, not in this file.

{
  "mcpServers": {
    "mcpdog": {
      "command": "npx",
      "args": ["mcpdog@latest"]
    }
  }
}

MCPdog config file example

The ~/.mcpdog/mcpdog.config.json file where MCPdog stores its server list. This is managed by the CLI but can be edited manually.

{
  "version": "2.0.0",
  "servers": {
    "playwright": {
      "name": "playwright",
      "enabled": true,
      "transport": "stdio",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "timeout": 30000
    },
    "my-api": {
      "name": "my-api",
      "enabled": true,
      "transport": "streamable-http",
      "url": "https://api.example.com"
    }
  }
}

Troubleshooting MCPdog

Tools from managed servers do not appear in the AI client

Restart the MCP client after adding new servers to MCPdog. MCPdog proxies tools on startup; a restart forces the client to re-fetch the tool list. Also verify the server shows as 'enabled' in 'npx mcpdog@latest config list'.

Dashboard at localhost:38881 is not reachable

MCPdog must be running (i.e., your MCP client must have it active). The dashboard only runs while the MCPdog process is alive. If using Docker, ensure port 38881 is mapped: '-p 38881:38881'.

A managed server fails to start via MCPdog

Check the live logs in the web dashboard for the specific server. The underlying server command must be executable on the host where MCPdog is running. Test the server command directly in your terminal before adding it to MCPdog.

Frequently Asked Questions about MCPdog

What is MCPdog?

MCPdog is a Model Context Protocol (MCP) server that ๐Ÿ• universal mcp server manager - configure once, manage multiple mcp servers through a single interface. perfect for claude desktop, claude code, cursor, gemini cli & ai assistants. web dashboard, auto-detection, unified proxy layer. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCPdog?

Follow the installation instructions on the MCPdog GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCPdog?

MCPdog works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCPdog free to use?

Yes, MCPdog is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcpdog": { "command": "npx", "args": ["-y", "mcpdog"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide โ†’

Ready to use MCPdog?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides