MCP Server Shell

壳牌MCP服务器

提供shell命令执行功能的模型上下文协议服务器。此服务器使LLM能够以受控的方式执行shell命令并接收其输出。

可用工具

• execute_command -执行shell命令并返回其输出

- 必需参数： - command （string）：要执行的Shell命令 - 退货： - 命令结果包含： - command：执行的命令 - output：组合stdout和stderr输出 - return_code：命令执行返回代码

安装

使用紫外线（推荐）

使用时 uv 不需要特定的安装。我们将 使用 uvx 直接运行 *mcp服务器外壳*.

使用PIP

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

pip install mcp-server-shell

安装后，您可以使用以下命令将其作为脚本运行：

python -m mcp_server_shell

配置

为Claude.app进行配置

添加到您的Claude设置中：

Using uvx

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

Using pip installation

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

为Zed配置

添加到您的Zed settings.json：

Using uvx

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

Using pip installation

"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 run mcp-server-shell

给克劳德的问题示例

1. “当前目录中有哪些文件？”
2. “显示README.md文件的内容”
3. “当前系统日期是什么？”
4. “检查是否安装了Python并显示其版本”

安全考虑

⚠️ 警告：此服务器直接在您的系统上执行shell命令。谨慎使用并实施适当的安全措施，以防止未经授权或危险的命令执行。

贡献

我们鼓励捐款以帮助扩展和改进mcp服务器外壳。无论您是想添加新功能、增强安全性还是改进文档，您的意见都是有价值的。

有关其他MCP服务器和实现模式的示例，请参阅： https://github.com/modelcontextprotocol/servers

欢迎拉取请求！请随时贡献新想法、错误修复或增强功能，使mcp服务器shell更加强大和有用。

许可证

mcp服务器shell根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。