Navigation
MCPGod: Master Control & Context Mastery - MCP Implementation

MCPGod: Master Control & Context Mastery

Master your MCP universe with fine-grained control over clients, servers, and tools—because context is God.

Developer Tools
4.1(87 reviews)
130 saves
60 comments

Ranked in the top 1% of all AI tools in its category

About MCPGod

What is MCPGod: Master Control & Context Mastery?

MCPGod is a command-line interface (CLI) tool engineered to simplify the management of Model Context Protocol (MCP) servers, clients, and tools. It acts as a central hub for developers, enabling precise control over server configurations, tool permissions, and logging processes. By abstracting complex workflows into intuitive commands, MCPGod ensures seamless integration with MCP ecosystems across all major operating systems.

How to Use MCPGod: Master Control & Context Mastery?

To harness MCPGod’s capabilities, developers start by installing it via npm or npx. Core operations include adding servers to specific clients, listing available tools, and executing commands on remote servers. For instance, adding a server to the "claude" client involves running `god add @modelcontextprotocol/server-everything -c claude`, while debugging is streamlined through timestamped logs stored in `~/mcpgod/logs`. Each action is designed for clarity, reducing the cognitive load of managing distributed MCP environments.

MCPGod Features

Key Features of MCPGod: Master Control & Context Mastery?

MCPGod’s strength lies in its modular design. It offers:

  • Granular Permissions: Restrict or grant access to specific tools for clients, ensuring secure server interactions.
  • Tool Discovery & Execution: Dynamically list and run tools on any server directly from the CLI, eliminating manual configuration.
  • Centralized Logging: Automatically log server runs with detailed timestamps, simplifying error tracing and performance analysis.

Use Cases of MCPGod: Master Control & Context Mastery?

Developers leverage MCPGod in scenarios like:

  • Scaling multi-tenant MCP environments by assigning servers to distinct clients.
  • Automating tool testing across servers without manual setup.
  • Debugging issues by analyzing structured logs for specific server runs.
  • Enforcing security policies through tool-level permissions.

MCPGod FAQ

FAQ from MCPGod: Master Control & Context Mastery?

  • Q: How do I check my MCPGod version?
    Run `god --version` to display the installed version.
  • Q: Where are logs stored?
    All logs reside in `~/mcpgod/logs`, organized by server name and timestamp for easy access.
  • Q: Can I use MCPGod without npm?
    Yes, execute commands via `npx -y mcpgod` for one-time usage without global installation.
  • Q: How do I restrict access to sensitive tools?
    Use `god add` with the `--tools` flag to limit clients to specific tools, e.g., `--tools=echo,add`.

Content

MCPGod

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

oclif Version Downloads/week License

Overview

MCPGod is a CLI tool designed to help developers manage MCP servers with speed and ease. Whether you need to add, run, list, or remove servers—or even interact with server tools— MCPGod provides a streamlined interface to handle all these tasks on Windows, macOS, or Linux.

Features

  • 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 and clean output for easy debugging.

Installation

Install mcpgod globally using npm:

npm install -g mcpgod

Verify the installation:

god --version

Or run directly with npx.

npx -y mcpgod

Usage

Access the CLI with the god command (or npx -y mcpgod). Below are some common examples:

  • Add a Server to a Client

Add an MCP server to a client (e.g., Claude) with god add <SERVER> -c <CLIENT>:

    god add @modelcontextprotocol/server-everything -c claude
  • Only Add Specific Tools to a Client

Only add specific tools to a client with god add <SERVER> -c <CLIENT> --tools=<COMMA_DELIMITED_LIST>:

    god add @modelcontextprotocol/server-everything -c claude --tools=echo,add
  • List Servers for a Client

List all configured servers for a specific client with god list -c <CLIENT>:

    god list -c claude
  • Remove a Server

Remove an MCP server from your client's configuration with god remove <SERVER> -c <CLIENT>:

    god remove @modelcontextprotocol/server-everything -c claude
  • Run a Server

Run a server process with detailed logging with god run <SERVER>:

    god run @modelcontextprotocol/server-everything
  • List Available Tools for a Server

Display the list of tools available on a server with god tools <SERVER>:

    god tools @modelcontextprotocol/server-everything
  • Call a Specific Tool on a Server

Interact with a tool by passing key-value properties with god tool <SERVER> <TOOL> [optional parameters]:

    god tool @modelcontextprotocol/server-everything add a=59 b=40

For a complete list of commands and options, simply run:

god --help

Logging

When running a server, mcpgod logs output to:

~/mcpgod/logs

Each log file is organized by server name and timestamped to help you trace and debug any issues that arise.

Development

mcpgod is built with the Oclif framework and uses the Model Context Protocol SDK for robust interactions with MCP servers.

Clone the repository to get started with development:

git clone https://github.com/mcpgod/cli.git
cd mcpgod
npm install

Run the CLI in development mode:

./bin/dev

Contributing

Contributions are always welcome! To contribute:

  1. Fork the repository.

  2. Create a branch :

    git checkout -b feature/your-feature

  3. Make your changes , and commit them:

    git commit -am 'Add new feature'

  4. Push your branch:

    git push origin feature/your-feature

  5. Open a Pull Request on GitHub.

License

This project is licensed under the MIT License.


Additional Resources


Related MCP Servers & Clients