cmd-line-executor-MCP

cmd-line-executor-MCP

3
os_automation

The cmd-line-executor MCP server is designed to interface with command line applications by implementing tools to execute commands and return their output. The project focuses on ease of installation and provides development tools like building, publishing, and debugging through the MCP Inspector.

cmd-line-executor MCP server

Example MCP server to call command line apps

Components

Tools

The server implements one tool:

  • run_command: Runs a command line comment
    • Takes "cmd" and "args" as string arguments
    • Runs the command and returns stdout, stderr, status_code, etc.

Quickstart

Install

Claude Desktop

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

Development

Building and Publishing

  1. Sync dependencies and update lockfile.
  2. Build package distributions. This will create source and wheel distributions in the dist/ directory.
  3. Publish to PyPI. Set PyPI credentials via environment variables or command flags.

Debugging

Use the MCP Inspector for debugging.