MCP Shell Server

一个安全的服务器，用于执行授权的shell命令，并支持通过stdin传递输入。此服务器实现了模型上下文协议（MCP），允许远程执行经过验证的shell命令。

功能

• 安全命令执行：仅允许执行受信任的命令
• 标准输入支持：可以通过stdin向命令提供输入
• 全面输出：返回stdout、stderr、退出状态码和执行时间
• shell操作符验证：在使用shell操作符（;，&&，||，|）时仍需进行命令验证
• 超时控制：为命令设置最大执行时间

客户端配置在Claude.app中

发布版本

code ~/Library/Application\ Support/Claude/claude.yaml

backend:
  class: mcp_shell_server.Backend
  config:
    server_uri: http://localhost:5000
    max_timeout: 3600

本地版本

poetry install
poetry run mcp-shell-server

安装说明

安装依赖项

pip install -e ".[test]"

启动服务器

uvicorn main:app --reload

验证安装

运行以下命令检查是否成功安装：

mcp-shell-server --version

使用说明

示例命令

示例1：执行基本命令

请求示例：

{
  "command": ["echo", "Hello, World!"],
  "stdin": null,
  "directory": "/",
  "timeout": 30
}

响应示例：

{
  "stdout": "Hello, World!\n",
  "stderr": "",
  "status": 0,
  "execution_time": 0.123456
}

示例2：带有标准输入的命令

请求示例：

{
  "command": ["tr", "a-z", "A-Z"],
  "stdin": "hello world\n",
  "directory": "/tmp",
  "timeout": 60
}

请求格式

请求参数

响应格式

开发说明

设置开发环境

1. 克隆仓库

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

2. 安装依赖项（包括测试要求）

pip install -e ".[test]"

执行测试

pytest

API参考文档

请求参数

响应参数

系统要求

• Python 3.11或更高版本
• mcp>=1.1.0

许可证

MIT许可证 - 请参阅LICENSE文件以获取详细信息