📌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

MCPGod is a CLI tool designed to help developers manage Model Context Protocol (MCP) servers with ease on Windows, macOS, or Linux.

Features

Client Management: Add, remove, and list MCP servers for specific clients.
Tool Discovery: List all tools on any MCP server.
Tool Calling: Run any tool on any MCP server directly from the command line.
Tool/Client Permissions: Manage specific tool permissions for clients.
Detailed Logging: Log each server run with timestamps for 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. Common examples include:

Add a Server to a Client:

god add @modelcontextprotocol/server-everything -c claude

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, run:

god --help

Logging

MCPGod logs output to:

~/mcpgod/logs

Log files are organized by server name and timestamp.

Development

Clone the repository to get started:

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

Run the CLI in development mode:

./bin/dev

Contributing

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.

cli