Shell Server
Click 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 Server run 'ls -la'"
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.
Shell Server
A simple MCP server that exposes a terminal tool, allowing AI agents to execute shell commands.
Requirements
Python 3.10+
Related MCP server: MCP Shell Server
Setup
uv venv
uv syncRunning
uv run server.pyOr during development with the MCP inspector:
uv run mcp dev server.pyTool
terminal
Executes a shell command and returns its output.
Input
Parameter | Type | Description |
| string | The shell command to execute |
Output
{
"stdout": "...",
"stderr": "...",
"return_code": 0
}Connecting to Cursor
Add the following to ~/.cursor/mcp.json:
{
"mcpServers": {
"shellserver": {
"command": "uv",
"args": [
"--directory",
"/Users/sami/Documents/MCP/mcp-servers/shellserver",
"run",
"server.py"
]
}
}
}Then restart Cursor. The terminal tool will be available to the Agent.
Security
This server executes arbitrary shell commands. Only run it locally and never expose it over a network.
Available Tools
1 toolterminalA
Run a terminal command and return the output.
Args: command: The command to execute in the terminal.
Returns: A dictionary containing stdout, stderr, and return_code.
Inputs: command (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility for confusion or overlap. The tool is clearly distinct.
A single tool's name cannot be inconsistent. There is no pattern to evaluate, but no conflicting conventions exist.
A single tool is too few for typical usage. The server would benefit from additional tools like file operations or environment variable management to be more useful.
The server only provides command execution. For a shell server, missing essential operations like reading files, managing directories, or handling processes limits its usefulness and may cause agent failures.
Maintenance
Related MCP Connectors
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server exposing the Backtest360 engine API as tools for AI agents.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Related MCP Servers
- AlicenseCqualityDmaintenanceA server that enables AI assistants to execute terminal commands and retrieve outputs via the Model Context Protocol (MCP).326MIT
- FlicenseNot gradedqualityNot gradedmaintenanceA simple MCP server that provides a terminal tool for executing shell commands with safety features like timeouts and error handling.-
- FlicenseBqualityDmaintenanceAn MCP server that enables users to execute arbitrary shell commands on their local machine and receive the output. It provides a terminal tool for running system commands through MCP-compatible clients using the Python SDK.1-
- FlicenseAqualityDmaintenanceA lightweight MCP server that provides AI assistants with access to a system's terminal through a secure terminal tool. It enables users to execute shell commands and receive stdout, stderr, and exit codes directly within an MCP-compatible client.1-