https://github.com/mcpgod/cli
Fine-grained control over model context protocol (MCP) clients, servers, and tools. Context is God.
https://github.com/mcpgod/cli
mcp mcp-admin mcp-analytics mcp-client mcp-ops mcp-server mcp-tools modelcontextprotocol
Last synced: 10 months ago
JSON representation
Fine-grained control over model context protocol (MCP) clients, servers, and tools. Context is God.
- Host: GitHub
- URL: https://github.com/mcpgod/cli
- Owner: mcpgod
- License: mit
- Created: 2025-03-10T21:10:11.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-03-21T14:01:45.000Z (10 months ago)
- Last Synced: 2025-04-02T04:05:36.812Z (10 months ago)
- Topics: mcp, mcp-admin, mcp-analytics, mcp-client, mcp-ops, mcp-server, mcp-tools, modelcontextprotocol
- Language: TypeScript
- Homepage: https://github.com/mcpgod/cli
- Size: 218 KB
- Stars: 100
- Watchers: 1
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MCPGod
> Fine-grained control over model context protocol (MCP) clients, servers, and tools. Context is God.
[](https://oclif.io)
[](https://npmjs.org/package/mcpgod)
[](https://npmjs.org/package/mcpgod)
[](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`:
```sh
npm install -g mcpgod
```
Verify the installation:
```sh
god --version
```
Or run directly with `npx`.
```sh
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 -c `:
```sh
god add @modelcontextprotocol/server-everything -c claude
```
- **Only Add Specific Tools to a Client**
Only add specific tools to a client with `god add -c --tools=`:
```sh
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 `:
```sh
god list -c claude
```
- **Remove a Server**
Remove an MCP server from your client's configuration with `god remove -c `:
```sh
god remove @modelcontextprotocol/server-everything -c claude
```
- **Run a Server**
Run a server process with detailed logging with `god run `:
```sh
god run @modelcontextprotocol/server-everything
```
- **List Available Tools for a Server**
Display the list of tools available on a server with `god tools `:
```sh
god tools @modelcontextprotocol/server-everything
```
- **Call a Specific Tool on a Server**
Interact with a tool by passing key-value properties with `god tool [optional parameters]`:
```sh
god tool @modelcontextprotocol/server-everything add a=59 b=40
```
For a complete list of commands and options, simply run:
```sh
god --help
```
## Logging
When running a server, **mcpgod** logs output to:
```plaintext
~/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](https://oclif.io) framework and uses the [Model Context Protocol SDK](https://modelcontextprotocol.org) for robust interactions with MCP servers.
Clone the repository to get started with development:
```sh
git clone https://github.com/mcpgod/cli.git
cd mcpgod
npm install
```
Run the CLI in development mode:
```sh
./bin/dev
```
## Contributing
Contributions are always welcome! To contribute:
1. **Fork** the repository.
2. **Create a branch**:
```sh
git checkout -b feature/your-feature
```
3. **Make your changes**, and commit them:
```sh
git commit -am 'Add new feature'
```
4. **Push** your branch:
```sh
git push origin feature/your-feature
```
5. **Open a Pull Request** on GitHub.
## License
This project is licensed under the [MIT License](LICENSE).
---
## Additional Resources
- [Oclif CLI Framework](https://oclif.io)
- [Model Context Protocol](https://modelcontextprotocol.org)
- [npm Package mcpgod](https://npmjs.org/package/mcpgod)
---