MCP Command Server

基本能力

产品定位

Andrew-Beniash_mcp-command-server 是一个安全的模型上下文协议（MCP）服务器，用于通过 LLM 应用程序执行系统命令。

核心功能

• 🔒 安全的命令执行，支持白名单
• ✅ 所有命令需要用户确认
• 📝 全面的审计日志
• 🔍 输入验证和清理
• 🤖 Claude Desktop 集成

适用场景

• 通过 LLM 应用程序安全地执行系统命令
• 需要审计和确认的命令执行环境
• 与 Claude Desktop 集成的开发工作流

工具列表

• uv pip install mcp-command-server：安装工具
• pytest：测试工具
• pytest --cov=mcp_command_server：带覆盖率的测试工具

常见问题解答

请参考 Troubleshooting 文档。

使用教程

使用依赖

1. 确保已安装 Python 和 uv 工具。

安装教程

1. 安装包：

uv pip install mcp-command-server

1. 配置允许的命令：

export ALLOWED_COMMANDS="ls,pwd,echo"

1. 添加到 Claude Desktop 配置：

{
  "mcpServers": {
    "command-server": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_command_server"],
      "env": {
        "ALLOWED_COMMANDS": "ls,pwd,echo"
      }
    }
  }
}

调试方式

1. 运行所有测试：

pytest

1. 运行特定测试文件：

pytest tests/unit/security/test_validator.py

1. 运行带覆盖率的测试：

pytest --cov=mcp_command_server

许可证

该项目遵循 MIT 开源许可条款。