Back to search
cli
SkillGitHub
Fine-grained control over model context protocol (MCP) clients, servers, and tools. Context is God.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/mcpgod--cli)HTML
<a href="/listings/mcpgod--cli"><img src="/api/listings/mcpgod--cli/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install **mcpgod** globally using `npm`:
npm install -g mcpgod
Verify the installation:
mcpgod --version
Or run directly with `npx`.
npx -y mcpgod
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 198 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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)
- ---
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.