Configurable Command MCP Server

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.

Features

• 🛠️ 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
• 📊 Output management: Size limits and structured result formatting

Setup Instructions

1. Create the project directory and install dependencies

cd /Users/dewoller/code/generic_mcp
npm install

2. Build the TypeScript code

npm run build

3. Configure your tools

Edit the `tools.json` file to define your command-line tools. The file is already configured with useful examples like:

• `list_files`: List directory contents
• `grep_search`: Search for patterns in files
• `word_count`: Count lines/words/characters
• `git_status`: Check git repository status
• `find_files`: Find files by pattern
• And more!

4. Configure Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`

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

5. Restart Claude Desktop

After saving the configuration, restart Claude Desktop to load the MCP server.

Testing the Installation

Run Integration Tests

npm run test:integration

This will test several tools and show you their output.

Manual Testing in Development Mode

# Run in development mode (with TypeScript)
npm run dev

# Or run the built version
npm start

Usage Examples

Once configured, you can ask Claude to use these tools:

• "List all JavaScript files in my code directory"
• "Search for TODO comments in the project"
• "Show me the git status"
• "Count lines in all Python files"
• "Find all markdown files"

Adding Custom Tools

To add a new tool, edit `tools.json`:

{
  "name": "my_tool",
  "description": "Description for Claude",
  "command": "actual-command",
  "args": ["-flag", "{parameter}"],
  "parameters