shellserver

一个使用 Python MCP SDK (FastMCP) 构建的小型 模型上下文协议 (MCP) 服务器。它提供了一个工具，用于在运行服务器进程的机器上执行 shell 命令。

要求

• Python 3.14+ (参见 pyproject.toml)

• uv 用于安装和运行依赖项

Related MCP server: Shell MCP Server

设置

克隆或复制此仓库，然后在项目根目录下执行：

uv sync

运行服务器

该服务器使用 stdio 传输（FastMCP 的默认设置）。

uv run python server.py

请勿从服务器进程向 stdout 管道传输额外数据；MCP 使用 stdout 进行 JSON-RPC 通信。server.py 中的日志记录已重定向至 stderr。

工具：terminal_tool

该工具返回一个包含 exit_code、stdout 和 stderr 的文本块。如果命令超过超时时间，进程将被终止，响应将指示超时。

连接客户端（本地运行示例）

将您的 MCP 主机指向 uv，并将此项目作为工作目录。配置示例结构如下：

{
  "mcpServers": {
    "shellserver": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/absolute/path/to/shellserver"
    }
  }
}

请根据您的编辑器或客户端调整键名和 cwd。

安全性

此服务器会在宿主机上执行任意 shell 命令。任何能够针对此服务器调用 MCP 工具的人，实际上都拥有该机器的 shell 访问权限。请仅在受信任的主机上、使用受信任的客户端，并在充分了解风险的情况下使用。