drio
Open app

🖥️ Shell MCP Server

Source

Secure shell command execution MCP server for Claude AI. Enables controlled shell access within specified directories.

Catalog onlyCatalog onlySTDIO

Overview

Shell MCP Server is a secure command execution server designed for AI applications, particularly for Claude AI, allowing controlled execution of shell commands within specified directories.

To use Shell MCP Server, install it via pip, configure your Claude Desktop application with the provided settings, and execute commands within allowed directories.

  • Secure Execution: Commands can only run in specified directories. - Multiple Shell Support: Compatible with bash, sh, cmd, and powershell. - Timeout Control: Automatically terminates long-running commands. - Cross-Platform: Functions on both Unix and Windows systems. - Safety Features: Built-in validation for directories and shells ensures security.
  1. Executing file system commands like listing or searching files.
  2. Performing project management tasks including Git operations and package management.
  3. Monitoring system resources and processes securely.
  4. Running scripts with controlled dependencies in specified environments.

Add to your AI client

Use these steps to connect 🖥️ Shell MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "shell-mcp-server-blazickjp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shell-mcp-server-blazickjp"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "shell-mcp-server-blazickjp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shell-mcp-server-blazickjp"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "shell-mcp-server-blazickjp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shell-mcp-server-blazickjp"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "shell-mcp-server-blazickjp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shell-mcp-server-blazickjp"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shell-mcp-server-blazickjp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shell-mcp-server-blazickjp"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "shell-mcp-server-blazickjp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shell-mcp-server-blazickjp"
      ]
    }
  }
}

FAQ

Can I execute any command using Shell MCP Server?

No, only commands within specified allowed directories will execute to ensure security.

How do I install Shell MCP Server?

You can install it using pip with the command 'pip install shell-mcp-server'.

Is Shell MCP Server free to use?

Yes, it is open-source and licensed under the MIT License.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":250,"uuid":"9c8787bb-5653-481a-973c-508384d18e8e","name":"shell-mcp-server","title":"🖥️ Shell MCP Server","description":"Secure shell command execution MCP server for Claude AI. Enables controlled shell access within specified directories.","avatar_url":"https://avatars.githubusercontent.com/u/15390319?v=4","created_at":"2024-12-13T10:43:36.383Z","updated_at":"2024-12-13T12:28:12.548Z","status":"created","author_name":"blazickjp","author_avatar_url":"https://avatars.githubusercontent.com/u/15390319?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/blazickjp/shell-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/b9627c4229a8c39d49bc0c1722f968a714c8e21f3678a47e9ea14da8cae47716/68747470733a2f2f62616467652e667572792e696f2f70792f7368656c6c2d6d63702d7365727665722e737667","type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools