cli

# 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) [](coverage/lcov-report/index.html) ## 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 mcpgod --version ``` Or run directly with `npx`. ```sh 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>`: ```sh 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>`: ```sh 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>`: ```sh mcpgod list -c claude ``` - **Remove a Server** Remove an MCP server from your client's configuration with `mcpgod remove <SERVER> -c <CLIENT>`: ```sh mcpgod remove @modelcontextprotocol/server-everything -c claude ``` - **Run a Server** Run a server process with detailed logging with `mcpgod run <SERVER>`: ```sh 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>`: ```sh 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]`: ```sh 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: ```sh mcpgod --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 ``` ## 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_EMAIL` and `GH_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: ```sh npm run lint:workflows ``` ## 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) ---