Shell MCP 服务器

一个提供壳命令执行功能的模型上下文协议 (Model Context Protocol) 服务器。此服务器使大型语言模型 (LLM) 能够以受控方式执行 shell 命令并接收其输出。

可用工具

• execute_command - 执行 shell 命令并返回其输出
  • 必需参数：
    • command（字符串）：要执行的 shell 命令
  • 返回：
    • 命令结果包括：
      • command：执行的命令
      • output：组合 stdout 和 stderr 输出
      • return_code：命令执行返回码

安装

使用 uv（推荐）

当使用 uv 时，无需任何特定安装。我们将直接使用 uvx 运行 mcp-server-shell。

使用 PIP

或者，您可以通过 pip 安装 mcp-server-shell：

pip install mcp-server-shell

安装后，您可以作为脚本运行它：

python -m mcp_server_shell

配置

为 Claude.app 配置

在您的 Claude 设置中添加：

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

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

为 Zed 配置

在您的 Zed settings.json 中添加：

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

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

示例交互

执行 shell 命令：

{
  "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 监视器调试服务器。对于 uvx 安装：

npx @modelcontextprotocol/inspector uvx mcp-server-shell

或者如果您在特定目录安装或开发该包：

cd path/to/servers/src/shell
npx @modelcontextprotocol/inspector uv mcp_server_shell

安全注意事项

• 输入验证：始终对用户提供的输入进行验证，避免命令注入攻击。
• 权限管理：限制服务器执行的命令权限，确保只有经过授权的操作被允许。

贡献指南

要为该项目做出贡献，请遵循以下步骤：

1. fork 仓库
2. 创建功能分支
3. 提交更改
4. 推送到 fork
5. 提交拉取请求

如需报告问题或提出功能请求，请在 GitHub 上打开问题。

许可证

[在此处添加许可证信息]

感谢您使用 mcp-server-shell！希望它能为您的项目提供强大的 shell 命令执行能力。