MCPGod

Fine-grained control over model context protocol (MCP) clients, servers, and tools. Context is God.

Catalog onlyCatalog onlySTDIO

Overview

MCPGod is a command-line interface (CLI) tool designed for developers to manage Model Context Protocol (MCP) clients, servers, and tools with fine-grained control.

To use MCPGod, install it globally via npm with npm install -g mcpgod, and access the CLI using the god command. You can add, list, remove servers, and interact with server tools directly from the command line.

Client Management: Add, remove, and list MCP servers for specific clients. - Tool Discovery: List every tool on any MCP server. - Tool Calling: Run any tool on any MCP server directly from the command line. - Tool/Client Permissions: Allow or block specific tools for specific clients. - Detailed Logging: Log every server run from every client with timestamps for easy debugging.

Managing multiple MCP servers for different clients.
Running server tools directly from the command line for automation.
Debugging server interactions with detailed logs.

Add to your AI client

Use these steps to connect MCPGod in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "cli-mcpgod": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-mcpgod"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "cli-mcpgod": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-mcpgod"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "cli-mcpgod": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-mcpgod"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "cli-mcpgod": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-mcpgod"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cli-mcpgod": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-mcpgod"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "cli-mcpgod": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-cli-mcpgod"
      ]
    }
  }
}

FAQ

Can MCPGod manage multiple servers?

Yes! MCPGod allows you to manage multiple MCP servers for different clients seamlessly.

Is MCPGod compatible with all operating systems?

Yes! MCPGod works on Windows, macOS, and Linux.

How can I contribute to MCPGod?

You can contribute by forking the repository, creating a branch, making changes, and opening a pull request on GitHub.

Developer tools