Shell MCP Server

Shell MCP Server

Shell MCP Server使LLM能够安全地执行shell命令，提供JSON输出、调试工具以及与AI应用的集成。

GitHub
Created Byodysseus0odysseus0

概述

Shell MCP Server 让大型语言模型能够执行 shell 命令并获取输出，遵循模型上下文协议(MCP)标准。

安装选项

使用 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 工具：

  • 参数: command (字符串)
  • 返回: 包含 command、output 和 return_code 的结果

使用示例

示例请求:

{
  "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

⚠️ 安全警告

该服务器直接在系统上执行命令，请谨慎使用并实施适当的安全措施。

更多信息