MCPGod
Fine-grained control over model context protocol (MCP) clients, servers, and tools. Context is God.
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:
mcpgod --version
Or run directly with npx.
npx -y mcpgod
Usage
Access the CLI with the mcpgod 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
mcpgod add <SERVER> -c <CLIENT>:mcpgod add @modelcontextprotocol/server-everything -c claude -
Only Add Specific Tools to a Client
Only add specific tools to a client with
mcpgod add <SERVER> -c <CLIENT> --tools=<COMMA_DELIMITED_LIST>:mcpgod add @modelcontextprotocol/server-everything -c claude --tools=echo,add -
List Servers for a Client
List all configured servers for a specific client with
mcpgod list -c <CLIENT>:mcpgod list -c claude -
Remove a Server
Remove an MCP server from your client's configuration with
mcpgod remove <SERVER> -c <CLIENT>:mcpgod remove @modelcontextprotocol/server-everything -c claude -
Run a Server
Run a server process with detailed logging with
mcpgod run <SERVER>:mcpgod run @modelcontextprotocol/server-everything mcpgod run ./mcp-server.py mcpgod run ./mcp-server-node.mjs -
List Available Tools for a Server
Display the list of tools available on a server with
mcpgod tools <SERVER>:mcpgod tools @modelcontextprotocol/server-everything mcpgod tools ./mcp-server.py mcpgod tools ./mcp-server-node.mjs -
Call a Specific Tool on a Server
Interact with a tool by passing key-value properties with
mcpgod tool <SERVER> <TOOL> [optional parameters]:mcpgod tool @modelcontextprotocol/server-everything add a=59 b=40 mcpgod tool ./mcp-server.py echo message=hi mcpgod tool ./mcp-server-node.mjs echo message=hi
For a complete list of commands and options, simply run:
mcpgod --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
Publishing
Automatic publishing is handled by the version, tag and github release workflow. A new npm version is published whenever a version bump is merged into the main branch. The workflow can also be triggered manually from the Actions tab.
To enable publishing, set the following repository secrets:
NPM_TOKEN– authentication token for npm.GH_EMAILandGH_USERNAME– used by the README update step.
Once the secrets are configured, pushing a new version or running the workflow manually will build the project, create a GitHub release and publish the package to npm.
Linting workflows
Before committing changes to workflows, you can lint them locally:
npm run lint:workflows
Contributing
Contributions are always welcome! To contribute:
- Fork the repository.
- Create a branch:
git checkout -b feature/your-feature - Make your changes, and commit them:
git commit -am 'Add new feature' - Push your branch:
git push origin feature/your-feature - Open a Pull Request on GitHub.
License
This project is licensed under the MIT License.