shell-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@shell-mcplist files in the current directory"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@supercorp/shell-mcp
An MCP server that gives AI agents shell access. Provides a run_command tool for executing shell commands and returning stdout, stderr, and exit code.
Supports Streamable HTTP, SSE, and stdio transports.
Quick start
npx @supercorp/shell-mcpThis starts an HTTP server on port 8000.
Related MCP server: TermPipe MCP
Usage
Streamable HTTP (default)
npx @supercorp/shell-mcp --port 3000SSE
npx @supercorp/shell-mcp --transport sse --port 3000stdio
npx @supercorp/shell-mcp --transport stdioOptions
Flag | Default | Description |
|
| Port to listen on (HTTP and SSE transports) |
|
| Transport type: |
|
| Default working directory for commands |
Tool
run_command
Execute a shell command.
Parameters:
Name | Type | Required | Description |
|
| Yes | The shell command to run |
|
| No | Working directory (overrides |
Response:
{
"stdout": "hello world\n",
"stderr": "",
"exitCode": 0
}Commands have a 60-second timeout and 10 MB output buffer.
MCP client configuration
Claude Desktop
{
"mcpServers": {
"shell": {
"command": "npx",
"args": ["-y", "@supercorp/shell-mcp", "--transport", "stdio"]
}
}
}HTTP client
{
"mcpServers": {
"shell": {
"url": "http://localhost:8000/"
}
}
}License
ISC
This server cannot be deployed
Maintenance
Related MCP Connectors
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
- mcp-serverOAuthcom.make
Give your AI agents the tools to build, manage, and run automation workflows.
Runtime permission, approval, and audit layer for AI agent tool execution.
Provides capabilities that let LLM agents perform a range of infrastructure management tasks.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to securely execute shell commands on local machines through an SSH interface with session management, command execution, and sudo support.1-
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants with direct terminal access to execute commands, manage files, and run persistent REPL sessions. It features automated installation scripts that educate AI assistants on its capabilities for seamless integration.MIT
- FlicenseAqualityCmaintenanceEnables AI agents to start and manage pseudo-terminal sessions, run shell commands and interact with REPLs programmatically.7-
- FlicenseBqualityDmaintenanceEnables LLMs to execute shell commands and perform file operations on a Linux system, exposing tools like execute_command, read_file, write_file, and more.10-