Generic MCP Server

Configurable command-line execution MCP server

Local serverstdioPython

What is the Generic MCP Server?

Configurable command-line execution MCP server

What it actually does

A flexible Model Context Protocol (MCP) server that allows you to define and execute arbitrary command-line tools through configuration files. Perfect for giving Claude Desktop access to specific command-line utilities in a secure, controlled manner.

  • 🛠️ Configuration-driven: Define tools via JSON without modifying code
  • 🔒 Secure execution: Parameter sanitization, directory restrictions, and command allowlisting
  • ⚡ Rate limiting: Prevent abuse with configurable execution limits
  • 📝 Parameter validation: Type checking, patterns, and required/optional parameters
  • 🎯 Directory scoping: Restrict tool execution to specific directories
  • ⏱️ Timeout control: Configurable execution timeouts per tool

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_filesList directory contents
grep_searchSearch for patterns in files
word_countCount lines/words/characters
git_statusCheck git repository status
find_filesFind files by pattern

How to install the Generic MCP Server

{
  "mcpServers": {
    "command-executor": {
      "command": "node",
      "args": [
        "/Users/dewoller/code/generic_mcp/dist/index.js"
      ],
      "env": {
        "CONFIG_PATH": "/Users/dewoller/code/generic_mcp/tools.json"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
CONFIG_PATHDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Generic MCP to list files.”
  • “Use Generic MCP to grep search.”
  • “Use Generic MCP to word count.”

Frequently asked questions

Configurable command-line execution MCP server Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.