🚀 MCP Shell Server
MCP Shell Server 是一个安全的命令执行服务器，它实现了模型上下文协议（MCP）。该服务器允许远程执行经过白名单允许的 shell 命令，并支持通过 stdin 传递输入，为用户提供了安全且便捷的命令执行环境。
🚀 快速开始
安装依赖项
pip install mcp-shell-server
启动服务器
ALLOW_COMMANDS="ls,cat,echo" uvx mcp-shell-server
# 或使用别名
ALLOWED_COMMANDS="ls ,echo, cat" uvx mcp-shell-server
环境变量 ALLOW_COMMANDS（或其别名 ALLOWED_COMMANDS）指定允许执行的命令。命令之间用逗号分隔，可带空格。
支持的 ALLOW_COMMANDS 格式：
lscatecho
发送请求
curl -X POST http://localhost:8000/execute \
-H "Content-Type: application/json" \
-d '{"command": "ls", "args": ["-a"]}'
✨ 主要特性
- 安全命令执行：仅允许白名单中的命令执行，保障系统安全。
- 标准输入支持：通过 (stdin) 传递输入到命令，方便灵活操作。
- 全面输出：返回 (stdout)、(stderr)、退出状态码和执行时间，让用户全面了解命令执行情况。
- shell 操作符安全性：在 shell 操作符（; , &&, ||, |）后验证命令，防止恶意操作。
- 超时控制：设置命令的最大执行时间，避免长时间占用资源。
📦 安装指南
发布版本
code ~/Library/Application\ 支持/Claude/claude_desktop_config.json
{
"mcpServers": {
"shell": {
"command": "uvx",
"args": [
"mcp-shell-server"
],
"env": {
"ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
}
}
}
}
本地版本
配置
code ~/Library/Application\ 支持/Claude/claude_desktop_config.json
{
"mcpServers": {
"shell": {
"command": "uv",
"args": [
"--directory",
".",
"run",
"mcp-shell-server"
],
"env": {
"ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
}
}
}
}
安装
pip install mcp-shell-server
💻 使用示例
基础用法
# 安装依赖项
pip install mcp-shell-server
# 启动服务器
mcp-shell-server start --port 8000
# 发送请求
curl -X POST http://localhost:8000/execute \
-H "Content-Type: application/json" \
-d '{"command": "ls", "args": ["-a"]}'
🔧 技术细节
安全措施
- 所有命令执行都在沙箱中进行，防止对系统造成损害。
- 禁止危险操作（如修改文件系统），保障系统数据安全。
- 限制资源使用，避免资源过度占用。
要求
- Python 3.11 或更高版本
- mcp >= 1.1.0
📄 许可证
本项目采用 MIT License，详情请参阅 LICENSE 文件。