Shell MCP 服务器

一个提供shell命令执行功能的模型上下文协议（Model Context Protocol）服务器。此服务器使大型语言模型能够安全地执行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 inspector调试服务器。对于uvx安装：

npx @modelcontextprotocol/inspector uvx mcp-server-shell

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

cd path/to/servers/src/shell
npx @modelcontextprotocol/inspector uv run mcp-server-shell

示例问题（针对Claude）

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

安全注意事项

⚠️ 警告：此服务器直接在本地执行shell命令。请确保输入的命令是可信的，以防止潜在的安全风险。

贡献指南

如需贡献，请参考项目文档或联系维护人员。

许可证

[此处添加许可证信息]