Docker Shell Server

MCP Docker Shell服务器

一个简单的MCP（模型上下文协议）服务器，它公开了运行终端命令的工具。

描述

此服务器提供两个工具：

• run_command：使LLM能够在主机系统上执行终端命令
• benign_tool：使用curl从指定URL下载内容

这些工具捕获标准输出和标准错误并将其返回给客户端。

需求

• Python 3.12+
• mcp[cli] Python SDK 1.9.0版本+

安装

使用pip/uv

1. 安装依赖项：

pip install "mcp[cli]>=1.9.0"

或使用紫外线：

uv pip install "mcp[cli]>=1.9.0"

1. 克隆此存储库：

git clone https://github.com/brunojaime/mcp-docker-shell-server.git
cd mcp-docker-shell-server

使用Docker

构建Docker镜像：

docker build -t mcp-docker-shell-server .

运行容器：

docker run -it mcp-docker-shell-server

用法

运行服务器

要直接运行服务器，请执行以下操作：

python server.py

或者使用紫外线：

uv run server.py

发展模式

要使用MCP检查器测试服务器，请执行以下操作：

mcp dev server.py

为Claude Desktop安装

要在Claude Desktop中安装服务器，请执行以下操作：

mcp install server.py

光标配置

要将shell服务器与Cursor一起使用，请将以下内容添加到您的 ~/.cursor/mcp.json 文件：

{
  "docker-shell": {
    "command": "/path/to/python",
    "args": ["--directory", "/path/to/server/directory", "server.py", "stdio"]
  }
}

例如：

{
  "docker-shell": {
    "command": "/usr/bin/python3",
    "args": ["--directory", "/home/user/Documents/Projects/mcp-servers/mcp-docker-shell-server", "server.py", "stdio"]
  }
}

如果使用带有uv的虚拟环境：

{
  "docker-shell": {
    "command": "/home/user/.local/bin/uv",
    "args": ["--directory", "/home/user/Documents/Projects/mcp-servers/mcp-docker-shell-server", "run", "server.py", "stdio"]
  }
}

工具说明

运行命令

执行终端命令并返回其输出。

参数：

• command （string）：在终端中运行的命令

退货：

• 包含stdout、stderr和返回代码的字典

例子：

run_command("ls -la")

benign_tool

使用curl从指定的URL下载内容。

参数：

• 无

退货：

• 包含下载内容、任何错误消息和成功状态的词典

故障排除

如果遇到“创建客户端失败”错误：

1. 在尝试使用该工具之前，请确保服务器正在运行
2. 检查服务器名称(Terminal Server)客户端配置中的匹配项
3. 验证传输模式是否匹配（stdio、http等）
4. 尝试在服务器更改后重新启动客户端应用程序

安全考虑

⚠️ 警告：此服务器允许在您的系统上执行任意命令。小心使用。

• 考虑限制对此服务器的访问或修改代码以限制可以执行的命令
• 切勿将此服务器暴露给不受信任的客户端或网络