MCPGod

What is MCPGod?

MCPGod is a CLI tool designed for fine-grained control over Model Context Protocol (MCP) clients, servers, and tools. It helps developers add, run, list, remove servers, and interact with server tools on Windows, macOS, or Linux.

How to use MCPGod?

Install globally with npm install -g mcpgod then use the mcpgod command. Common operations include adding a server to a client with mcpgod add <SERVER> -c <CLIENT>, listing servers, removing them, running a server, listing tools with mcpgod tools <SERVER>, and calling a tool with mcpgod tool <SERVER> <TOOL> [parameters].

Key features of MCPGod

• Add, remove, and list MCP servers for specific clients.
• Discover and list every tool on any MCP server.
• Call any tool on any server from the command line.
• Allow or block specific tools for specific clients.
• Detailed logging of every server run with timestamps.

Use cases of MCPGod

• Add an MCP server (e.g., @modelcontextprotocol/server-everything) to a client like Claude.
• Add only specific tools (e.g., echo, add) from a server to a client.
• List all configured servers for a client and remove unwanted ones.
• Discover available tools on any server and call them with custom parameters.
• Debug server issues by reading timestamped logs stored under ~/mcpgod/logs.

FAQ from MCPGod

How do I install MCPGod?

Install globally via npm: npm install -g mcpgod. Verify with mcpgod --version. You can also run directly with npx -y mcpgod.

How do I add a server to a specific client?

Use mcpgod add <SERVER> -c <CLIENT>. To add only specific tools, append --tools=<COMMA_DELIMITED_LIST>.

Where are logs stored?

Logs are saved to ~/mcpgod/logs, organized by server name and timestamped for easy debugging.

What platforms does MCPGod support?

MCPGod runs on Windows, macOS, and Linux. It requires Node.js and npm.

Can I call a tool on a server from the command line?

Yes, use mcpgod tool <SERVER> <TOOL> [parameters] to pass key-value properties and execute the tool.