Shell MCP Server

@odysseus0

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

odysseus0

关于 Shell MCP Server

暂无概览

Shell MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-shell": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_shell"
      ]
    }
  }
}

Shell MCP Server 工具

Execute a shell command and return its output

概览

What is Shell MCP Server?

A Model Context Protocol server that provides shell command execution capabilities. It enables LLMs to execute shell commands and receive their output in a controlled manner.

How to use Shell MCP Server?

Install via uvx mcp-server-shell or pip install mcp-server-shell, then configure the server in your MCP client (e.g., Claude.app or Zed) by adding the appropriate JSON entry. Use the execute_command tool with a command string argument to run any shell command.

Key features of Shell MCP Server

Executes shell commands and returns combined stdout/stderr output.
Returns the command’s exit code for success/failure detection.
Supports installation via uv (uvx) or pip.
Ready‑made configurations for Claude.app and Zed.
Can be debugged using the MCP inspector.
Licensed under the MIT License.

Use cases of Shell MCP Server

“List files in the current directory.”
“Show the contents of a specific file (e.g., README.md).”
“Check the current system date.”
“Verify if Python is installed and its version.”

常见问题

What does the Shell MCP Server do?

It gives LLMs the ability to run arbitrary shell commands and receive their output (stdout, stderr) and exit code in real time.

How do I install the Shell MCP Server?

You can run it directly with `uvx mcp-server-shell` (no install needed) or install it via `pip install mcp-server-shell` and then execute `python -m mcp_server_shell`.

How do I configure the server for Claude.app?

Add a JSON entry to your Claude settings under `mcpServers` – either using `uvx` or `python` as the command, with the appropriate arguments.

Are there security risks?

Yes. The server executes shell commands directly on your system. Use with caution and implement appropriate security measures to prevent unauthorized or dangerous command execution.

How can I debug the server?

Use the MCP inspector tool: run `npx @modelcontextprotocol/inspector uvx mcp-server-shell` (or a similar command for pip installations).

开发工具分类下的更多 MCP 服务器

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

qrp-mcp

StanimirTenev

Find quantum-vulnerable cryptography in your codebase — secp256k1, Ed25519, BLS, Schnorr, RSA. Local, offline MCP server for AI agents.

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac

LastPing

Know when your AI agents, cron jobs and CI pipelines fail, stall or go quiet. Your agent sets up monitors from a plain description, tells you what is broken and why, reads run history and traces, and writes notes on inci

Termany

thinkany-ai

Agent-Native Terminal

174