Skip to content
Back to search

cli

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mcpgod--cli/badge.svg)](/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)

  1. # MCPGod
  2. > Fine-grained control over model context protocol (MCP) clients, servers, and tools. Context is God.
  3. [![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
  4. [![Version](https://img.shields.io/npm/v/mcpgod.svg)](https://npmjs.org/package/mcpgod)
  5. [![Downloads/week](https://img.shields.io/npm/dw/mcpgod.svg)](https://npmjs.org/package/mcpgod)
  6. [![License](https://img.shields.io/npm/l/mcpgod.svg)](LICENSE)
  7. [![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)](coverage/lcov-report/index.html)
  8. ## Overview
  9. **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.
  10. ## Features
  11. - **Client Management**
  12. Add, remove, and list MCP servers for specific clients.
  13. - **Tool Discovery**
  14. List every tool on any MCP server.
  15. - **Tool Calling**
  16. Run any tool on any MCP server directly from the command line.
  17. - **Tool/Client Permissions**
  18. Allow or block specific tools for specific clients.
  19. - **Detailed Logging**
  20. Log every server run from every client, with timestamps and clean output for easy debugging.
  21. ## Installation
  22. Install **mcpgod** globally using `npm`:
  23. ```sh
  24. npm install -g mcpgod
  25. ```
  26. Verify the installation:
  27. ```sh
  28. mcpgod --version
  29. ```
  30. Or run directly with `npx`.
  31. ```sh
  32. npx -y mcpgod
  33. ```
  34. ## Usage
  35. Access the CLI with the `mcpgod` command (or `npx -y mcpgod`). Below are some common examples:
  36. - **Add a Server to a Client**
  37. Add an MCP server to a client (e.g., Claude) with `mcpgod add <SERVER> -c <CLIENT>`:
  38. ```sh
  39. mcpgod add @modelcontextprotocol/server-everything -c claude
  40. ```
  41. - **Only Add Specific Tools to a Client**
  42. Only add specific tools to a client with `mcpgod add <SERVER> -c <CLIENT> --tools=<COMMA_DELIMITED_LIST>`:
  43. ```sh
  44. mcpgod add @modelcontextprotocol/server-everything -c claude --tools=echo,add
  45. ```
  46. - **List Servers for a Client**
  47. List all configured servers for a specific client with `mcpgod list -c <CLIENT>`:
  48. ```sh
  49. mcpgod list -c claude
  50. ```
  51. - **Remove a Server**
  52. Remove an MCP server from your client's configuration with `mcpgod remove <SERVER> -c <CLIENT>`:
  53. ```sh
  54. mcpgod remove @modelcontextprotocol/server-everything -c claude
  55. ```
  56. - **Run a Server**
  57. Run a server process with detailed logging with `mcpgod run <SERVER>`:
  58. ```sh
  59. mcpgod run @modelcontextprotocol/server-everything
  60. mcpgod run ./mcp-server.py
  61. mcpgod run ./mcp-server-node.mjs
  62. ```
  63. - **List Available Tools for a Server**
  64. Display the list of tools available on a server with `mcpgod tools <SERVER>`:
  65. ```sh
  66. mcpgod tools @modelcontextprotocol/server-everything
  67. mcpgod tools ./mcp-server.py
  68. mcpgod tools ./mcp-server-node.mjs
  69. ```
  70. - **Call a Specific Tool on a Server**
  71. Interact with a tool by passing key-value properties with `mcpgod tool <SERVER> <TOOL> [optional parameters]`:
  72. ```sh
  73. mcpgod tool @modelcontextprotocol/server-everything add a=59 b=40
  74. mcpgod tool ./mcp-server.py echo message=hi
  75. mcpgod tool ./mcp-server-node.mjs echo message=hi
  76. ```
  77. For a complete list of commands and options, simply run:
  78. ```sh
  79. mcpgod --help
  80. ```
  81. ## Logging
  82. When running a server, **mcpgod** logs output to:
  83. ```plaintext
  84. ~/mcpgod/logs
  85. ```
  86. Each log file is organized by server name and timestamped to help you trace and debug any issues that arise.
  87. ## Development
  88. **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.
  89. Clone the repository to get started with development:
  90. ```sh
  91. git clone https://github.com/mcpgod/cli.git
  92. cd mcpgod
  93. npm install
  94. ```
  95. Run the CLI in development mode:
  96. ```sh
  97. ./bin/dev
  98. ```
  99. ## Publishing
  100. 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.
  101. To enable publishing, set the following repository secrets:
  102. - `NPM_TOKEN` – authentication token for npm.
  103. - `GH_EMAIL` and `GH_USERNAME` – used by the README update step.
  104. 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.
  105. ### Linting workflows
  106. Before committing changes to workflows, you can lint them locally:
  107. ```sh
  108. npm run lint:workflows
  109. ```
  110. ## Contributing
  111. Contributions are always welcome! To contribute:
  112. 1. **Fork** the repository.
  113. 2. **Create a branch**:
  114. ```sh
  115. git checkout -b feature/your-feature
  116. ```
  117. 3. **Make your changes**, and commit them:
  118. ```sh
  119. git commit -am 'Add new feature'
  120. ```
  121. 4. **Push** your branch:
  122. ```sh
  123. git push origin feature/your-feature
  124. ```
  125. 5. **Open a Pull Request** on GitHub.
  126. ## License
  127. This project is licensed under the [MIT License](LICENSE).
  128. ---
  129. ## Additional Resources
  130. - [Oclif CLI Framework](https://oclif.io)
  131. - [Model Context Protocol](https://modelcontextprotocol.org)
  132. - [npm Package mcpgod](https://npmjs.org/package/mcpgod)
  133. ---

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.