Сервер Model Context Protocol (MCP), который раскрывает проверенные в бою возможности выполнения кода агента Zero.

Этот MCP-сервер позволяет любому агенту ИИ (Claude, Cursor, Windsurf и т.д.) выполнять команды терминала и код Python в хост-системе с использованием проверенной реализации Agent Zero.

Особенности

** Исполнять команды терминала**: выполнять команды оболочки с сохранением полной сессии ** Исполнить код Python**: запускать код Python через IPython с помощью управления сессиями ** Несколько сессий**: Поддержание отдельных контекстов исполнения Умная обработка выходных данных: автоматическое обнаружение, управление тайм-аутом и обнаружение диалога Cross-Platform: Работает на Linux, macOS и Windows (экспериментально)

Конфигурация клиента MCP (не требуется установка)

Добавьте в приложение конфигурацию MCP:

• простой случай с использованием uvx

• или pipx, если uvx не установлен

##Дополнительная конфигурация

Сервер MCP может быть настроен через переменные среды:

Дополнительные примеры

• начать сеансы с пользовательской оболочкой и питоновой средой + регистрация

• отменить тайм-ауты

Ручная инсталляция

и работать с конфигурацией:

Доступные инструменты

execution terminal

Выполните команду терминала в указанном сеансе.

Code Execution MCP Server

A Model Context Protocol (MCP) server that exposes Agent Zero’s battle-tested code execution capabilities.

This MCP server allows any AI agent (Claude, Cursor, Windsurf, etc.) to execute terminal commands and Python code on the host system using Agent Zero’s proven implementation.

Features

• Execute Terminal Commands: Run shell commands with full session persistence
• Execute Python Code: Run Python code via IPython with session management
• Multiple Sessions: Maintain separate execution contexts
• Smart Output Handling: Automatic prompt detection, timeout management, and dialog detection
• Cross-Platform: Works on Linux, macOS, and Windows (experimental)

MCP Client Configuration (no installation needed)

Add to your application MCP config:

• simple case using uvx

{
  "mcpServers": {
    "code-execution": {
      "command": "uvx",
      "args": ["code-execution-mcp"]
    }
  }
}

• or pipx if uvx is not installed

{
  "mcpServers": {
    "code-execution": {
      "command": "pipx",
      "args": ["run", "code-execution-mcp"]
    }
  }
}

Additional configuration

The MCP server can be configured via environment variables:

# Shell executable (default: /bin/bash on Unix, powershell.exe on Windows)
export CODE_EXEC_EXECUTABLE=/bin/bash

# Init commands (semicolon-separated, run when creating new sessions, empty by default)
export CODE_EXEC_INIT_COMMANDS="source /path/to/venv/bin/activate;export PATH=\$PATH:/custom/bin"

# Timeout configuration (in seconds)
export CODE_EXEC_FIRST_OUTPUT_TIMEOUT=30      # Wait for first output
export CODE_EXEC_BETWEEN_OUTPUT_TIMEOUT=15    # Wait between output chunks
export CODE_EXEC_DIALOG_TIMEOUT=5             # Detect dialog prompts
export CODE_EXEC_MAX_EXEC_TIMEOUT=180         # Maximum execution time

# Log directory (default empty = logging disabled)
export CODE_EXEC_LOG_DIR=/path/to/logs

Additional examples

• start sessions with custom shell and python environment + logging

{
  "mcpServers": {
    "code-execution-mcp": {
      "command": "uvx",
      "args": ["code-execution-mcp"],
      "env": {
        "CODE_EXEC_EXECUTABLE": "/bin/zsh",
        "CODE_EXEC_INIT_COMMANDS": "source /Users/lazy/Projects/code-execution-mcp/.venv/bin/activate",
        "CODE_EXEC_LOG_DIR": "/Users/lazy/Projects/code-execution-mcp/logs"
      }
    }
  }
}

• override timeouts

{
  "mcpServers": {
    "code-execution-mcp": {
      "command": "uvx",
      "args": ["code-execution-mcp"],
      "env": {
        "CODE_EXEC_FIRST_OUTPUT_TIMEOUT": "60",
        "CODE_EXEC_MAX_EXEC_TIMEOUT": "300"
      }
    }
  }
}

Manual installation

# Clone or download this package, then navigate to the directory
git clone https://github.com/agent0ai/code-execution-mcp.git
cd /code-execution-mcp

# Install dependencies
pip install -e .