Dynamic Shell Commands

v1.0.0Developer Toolsstable

Dynamic Shell Command MCP Server

anthropicanthropic-claudeclicommand-linemcp
Share:
41
Stars
0
Downloads
0
Weekly
0/5

What is Dynamic Shell Commands?

Dynamic Shell Commands is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to dynamic shell command mcp server

Dynamic Shell Command MCP Server

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Dynamic Shell Command MCP Server

Use Cases

Shell command execution via MCP
codelion

Maintainer

LicenseApache-2.0
Languagepython
Versionv1.0.0
UpdatedFeb 5, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx dynamic-shell

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Dynamic Shell Commands

Dynamic Shell MCP Server is a Python-based MCP server that lets AI assistants execute shell commands on your local machine with a built-in approval workflow. The first time any command is run, the user is prompted to allow it once or permanently; approved commands are stored persistently so future executions are automatic. This design gives you fine-grained control over what your AI assistant can do at the OS level while still enabling powerful automation.

Prerequisites

  • Python 3.8 or higher installed
  • pip to install Python dependencies
  • Claude Desktop or another MCP-compatible client
  • Git to clone the repository (not available on PyPI)
1

Clone the repository

Clone the dynamic-shell-server repository from GitHub.

git clone https://github.com/codelion/dynamic-shell-server.git
cd dynamic-shell-server
2

Create a virtual environment and install dependencies

Use a Python virtual environment to isolate dependencies, then install the required packages.

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
3

Test the server standalone

Run the server directly to verify it starts without errors before connecting it to an MCP client.

python dynamic_shell_server.py
4

Configure Claude Desktop

Add the server to your Claude Desktop config file. Use the absolute path to your Python executable inside the virtual environment.

{
  "mcpServers": {
    "dynamic-shell": {
      "command": "/absolute/path/to/dynamic-shell-server/.venv/bin/python",
      "args": ["/absolute/path/to/dynamic-shell-server/dynamic_shell_server.py"]
    }
  }
}
5

Restart Claude Desktop

Quit and reopen Claude Desktop to load the new MCP server configuration.

6

Approve commands on first use

When Claude first runs a command, you will be prompted to allow it once, allow it permanently, or deny it. Approved commands are stored in ~/.config/mcp-shell-server/ for future sessions.

Dynamic Shell Commands Examples

Client configuration

Claude Desktop config using the virtual environment Python interpreter to run the dynamic shell server.

{
  "mcpServers": {
    "dynamic-shell": {
      "command": "/absolute/path/to/dynamic-shell-server/.venv/bin/python",
      "args": ["/absolute/path/to/dynamic-shell-server/dynamic_shell_server.py"]
    }
  }
}

Prompts to try

Example prompts that use the execute_command tool to run shell commands with the approval workflow.

- "List all running processes on my machine"
- "Check available disk space with df -h"
- "Show me the last 20 lines of /var/log/syslog"
- "What commands have I previously approved? Check the approved commands list."
- "Revoke approval for the 'ls' command"

Troubleshooting Dynamic Shell Commands

Server fails to start with import errors

Make sure you activated the virtual environment before running pip install, and that you are using the virtual environment's Python executable in your MCP config, not the system Python.

Command times out with no output

The server enforces a 5-minute timeout on all commands. Long-running commands will be terminated. Split large tasks into smaller commands, or avoid commands that require interactive input.

Previously approved commands require re-approval after restart

Approved commands are stored in ~/.config/mcp-shell-server/. Verify this directory exists and is writable. If the directory is missing, create it manually: mkdir -p ~/.config/mcp-shell-server

Frequently Asked Questions about Dynamic Shell Commands

What is Dynamic Shell Commands?

Dynamic Shell Commands is a Model Context Protocol (MCP) server that dynamic shell command mcp server It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Dynamic Shell Commands?

Follow the installation instructions on the Dynamic Shell Commands GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Dynamic Shell Commands?

Dynamic Shell Commands works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Dynamic Shell Commands free to use?

Yes, Dynamic Shell Commands is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "dynamic-shell": { "command": "npx", "args": ["-y", "dynamic-shell"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Dynamic Shell Commands?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides