ShellExec MCP Server

MCP (Model Context Protocol) server for ShellExec. Lets AI assistants like Claude, Cursor, and Windsurf manage your servers through ShellExec.

Available Tools

| Tool | Description | |------|-------------| | list_agents | List all agents with status | | get_agent | Get details for a specific agent | | execute_command | Run a command on one agent | | execute_on_all | Run a command on all online agents | | get_allowlist | View allowed commands | | get_command_history | View recent command history |

Setup

Claude Desktop / Claude Code

Add to your Claude config (~/.claude.json or Claude Desktop settings):

{
  "mcpServers": {
    "shellexec": {
      "command": "npx",
      "args": ["-y", "shellexec-mcp", "--api-key", "sk-your-api-key"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "shellexec": {
      "command": "npx",
      "args": ["-y", "shellexec-mcp", "--api-key", "sk-your-api-key"]
    }
  }
}

Environment variables

Alternatively, use environment variables:

{
  "mcpServers": {
    "shellexec": {
      "command": "npx",
      "args": ["-y", "shellexec-mcp"],
      "env": {
        "SHELLEXEC_API_KEY": "sk-your-api-key",
        "SHELLEXEC_API_URL": "https://app.shellexec.sh"
      }
    }
  }
}

Usage Examples

Once configured, you can ask your AI assistant:

• "List my servers"
• "Check the uptime on all agents"
• "Run df -h on web-1"
• "What commands have been run today?"
• "Show me the disk usage across all servers"
• "What commands are in the allowlist?"

Configuration

| Option | Env Var | CLI Flag | Default | |--------|---------|----------|---------| | API Key | SHELLEXEC_API_KEY | --api-key | Required | | API URL | SHELLEXEC_API_URL | --api-url | https://app.shellexec.sh |

Development

npm install
npm run build
SHELLEXEC_API_KEY=sk-... node dist/index.js