MCP ExplorerExplorer

Cmd Line Executor Mcp

@MarkusPfundsteinon 9 months ago
3 MIT
FreeCommunity
AI Systems
Experimental MCP server to execute command line commands

Overview

What is Cmd Line Executor Mcp

cmd-line-executor-MCP is an experimental MCP server designed to execute command line commands. It provides a simple interface to run command line applications and retrieve their outputs.

Use cases

Use cases include executing scripts, automating tasks, debugging applications, and integrating command line tools into workflows.

How to use

To use cmd-line-executor-MCP, configure it in the Claude Desktop settings by specifying the command and arguments. You can run commands by calling the ‘run_command’ tool, which takes ‘cmd’ and ‘args’ as string inputs.

Key features

Key features include the ability to run command line commands, return standard output (stdout), standard error (stderr), and status codes. It supports both development and published server configurations.

Where to use

cmd-line-executor-MCP can be used in various fields such as software development, automation, and testing, where command line execution is required.

Content

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.

Configuration

Quickstart

Install

Claude Desktop

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

Development/Unpublished Servers Configuration ``` "mcpServers": { "cmd-line-executor": { "command": "uv", "args": [ "--directory", "/Users/$(whoami)/experiments/claude-mvp/cmd-line-executor", "run", "cmd-line-executor" ] } } ```
Published Servers Configuration ``` "mcpServers": { "cmd-line-executor": { "command": "uvx", "args": [ "cmd-line-executor" ] } } ```

Development

Building and Publishing

To prepare the package for distribution:

  1. Sync dependencies and update lockfile:
uv sync
  1. Build package distributions:
uv build

This will create source and wheel distributions in the dist/ directory.

  1. Publish to PyPI:
uv publish

Note: You’ll need to set PyPI credentials via environment variables or command flags:

  • Token: --token or UV_PUBLISH_TOKEN
  • Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best debugging
experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv --directory /Users/markus/experiments/claude-mvp/cmd-line-executor run cmd-line-executor

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers