executor-mcp

# Executor MCP Server An MCP (Model Context Protocol) server for managing interactive CLI binary processes. This server enables AI assistants to launch persistent binary processes, send stdin commands, and read stdout/stderr responses over time. ## Features - **Persistent Process Management**: Launch binaries that run in the background - **Interactive I/O**: Send commands to stdin and read from stdout/stderr - **Output Buffering**: Keeps last 1000 lines in memory per stream - **Comprehensive Logging**: All I/O is logged to timestamped files - **Multiple Process Support**: Manage multiple binaries simultaneously - **Real-time Output**: Background tasks continuously capture output ## Important Note This MCP server uses **stdio transport** for communication with MCP clients (like Claude Desktop). This is separate from the stdin/stdout of the binaries being managed. The server manages the stdin/stdout of your target binaries independently. ## Installation ### From Source ```bash # Clone or navigate to the directory cd skills/mcp-builder/runner # Install in development mode pip install -e . # Or install from the directory pip install . ``` ### Dependencies - Python >= 3.10 - mcp >= 1.1.0 - pydantic >= 2.0.0 ## Usage ### Starting the MCP Server The server runs using stdio transport (default for MCP): ```bash executor-mcp ``` Or run directly: ```bash python executor_mcp.py ``` ### Configuration Configure via environment variable: ```bash export EXECUTOR_LOG_DIR="$HOME/.executor-mcp/logs" executor-mcp ``` Default log directory: `.executor-mcp/` ### Configuring with Claude Desktop Add to your Claude Desktop configuration: **MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` **Linux**: `~/.config/Claude/claude_desktop_config.json` ```json { "mcpServers": { "executor": { "command": "python", "args": ["/absolute/path/to/executor_mcp.py"], "env"…