MCP 命令服务器

一个安全的模型上下文协议 (MCP) 服务器，用于通过像 Claude 这样的 LLM 应用程序执行系统命令。

快速开始

1. 安装包：

uv pip install mcp-command-server

2. 配置允许的命令：

export ALLOWED_COMMANDS="ls,pwd,echo"

3. 添加到 Claude Desktop 配置：

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

特性

• 🔒 使用白名单的安全命令执行
• ✅ 所有命令都需要用户确认
• 📝 完整的审计日志记录
• 🔍 输入验证和清理
• 🤖 Claude Desktop 集成

文档

有关完整文档，请参阅 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. Fork 仓库
2. 创建您的特性分支
3. 运行测试和 linting
4. 提交 pull request

许可证

MIT 许可证 - 详情请参阅 LICENSE。