📌Overview

Purpose: MCPGod is designed to provide developers with a command-line interface to efficiently manage Model Context Protocol (MCP) servers.

Overview: MCPGod simplifies the management of MCP servers, allowing for quick operations such as adding, removing, and interacting with server tools on various operating systems including Windows, macOS, and Linux.

Key Features:

Client Management: Easily add, remove, and list MCP servers associated with specific clients.
Tool Discovery: Access and list all tools available on any MCP server.
Tool Calling: Execute any tool directly from the command line on the designated MCP server.
Tool/Client Permissions: Manage which tools can be used by specific clients through permission settings.
Detailed Logging: Comprehensive logging of all server activities for clients, complete with timestamps for effective debugging.

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 interact with server tools—MCPGod provides a streamlined interface 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 with 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). Common commands:

Add a Server to a Client

god add @modelcontextprotocol/server-everything -c claude

Only Add Specific Tools to a Client

god add @modelcontextprotocol/server-everything -c claude --tools=echo,add

List Servers for a Client
```
god list -c claude
```

Remove a Server

god remove @modelcontextprotocol/server-everything -c claude

Run a Server

god run @modelcontextprotocol/server-everything

List Available Tools for a Server

god tools @modelcontextprotocol/server-everything

Call a Specific Tool on a Server

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

For a complete list of commands and options:

god --help

Logging

Logs are saved in:

~/mcpgod/logs

Each log file is organized by server name and timestamped for easy debugging.

Development

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

To start development:

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

Contributing

Contributions are welcome! To contribute:

Fork the repository.
Create a branch:
```
git checkout -b feature/your-feature
```
Make changes and commit:
```
git commit -am 'Add new feature'
```
Push the branch:
```
git push origin feature/your-feature
```
Open a Pull Request on GitHub.

License

This project is licensed under the MIT License.

cli