Command Security Layer

🚀 MCP 命令服务器

MCP 命令服务器是一个安全的模型上下文协议（MCP）服务器，可借助像 Claude 这类大型语言模型应用来执行系统命令，保障命令执行的安全性与可控性。

🚀 快速开始

安装软件包

uv pip install mcp-command-server

配置允许的命令

export ALLOWED_COMMANDS="ls,pwd,echo"

添加到 Claude Desktop 配置中

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

✨ 主要特性

• 🔒 带有白名单的安全命令执行，确保只有指定命令可被执行。
• ✅ 所有命令的用户确认，增强操作的可控性。
• 📝 全面审计日志记录，便于后续追溯与审查。
• 🔍 输入验证和清理，防止恶意输入。
• 🤖 Claude Desktop 集成，方便与 Claude 协同工作。

📚 详细文档

有关完整文档，请查看docs/目录：

• 安装指南
• 安全指南
• API 参考
• 使用示例
• 故障排除

🔧 技术细节

设置

# 克隆仓库
git clone https://github.com/yourusername/mcp-command-server.git
cd mcp-command-server

# 创建虚拟环境
uv venv
source .venv/bin/activate  # 在Unix/macOS上
.venv\Scripts\activate     # 在Windows上

# 安装开发依赖项
uv pip install -e ".[dev]"

测试

# 运行所有测试
pytest

# 运行特定的测试文件
pytest tests/unit/security/test_validator.py

# 带覆盖率运行
pytest --cov=mcp_command_server

贡献

1. 叉克隆仓库
2. 创建功能分支
3. 运行测试和代码检查
4. 提交拉取请求

📄 许可证

本项目采用 MIT 许可证，详情请见LICENSE。