Shell MCP Server

简介

MCP Shell 服务器允许大语言模型以受控方式执行 shell 命令并接收输出。

安装选项

使用 uv（推荐）：

# 无需安装，直接使用 uvx 运行

使用 PIP：

pip install mcp-server-shell

配置

Claude.app 配置

使用 uvx：

"mcpServers": {
  "shell": {
    "command": "uvx",
    "args": ["mcp-server-shell"]
  }
}

使用 pip 安装：

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

Zed 配置

使用 uvx：

"context_servers": {
  "mcp-server-shell": {
    "command": "uvx",
    "args": ["mcp-server-shell"]
  }
},

使用 pip 安装：

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

可用工具

• execute_command - 执行 shell 命令并返回输出
  • 参数：command (字符串)
  • 返回：命令结果对象（包含命令、输出和返回码）

示例用法

命令请求：

{
  "name": "execute_command",
  "arguments": {
    "command": "ls -la"
  }
}

响应：

{
  "command": "ls -la",
  "output": "total 24\ndrwxr-xr-x  5 user  group   160 Jan  1 12:00 .\ndrwxr-xr-x  3 user  group    96 Jan  1 12:00 ..",
  "return_code": 0
}

调试

使用 MCP 检查器：

npx @modelcontextprotocol/inspector uvx mcp-server-shell

注意事项

⚠️ 警告：此服务器直接在您的系统上执行 shell 命令。请谨慎使用，确保安全措施到位。

更多信息

请访问：https://github.com/modelcontextprotocol/servers