MCP命令服务器

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

  • by Andrew-Beniash
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 andrew-beniash/mcp-command-server

使用说明

MCP命令服务器

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

快速开始

  1. 安装软件包:
uv pip install mcp-command-server
  1. 配置允许的命令:
export ALLOWED_COMMANDS="ls,pwd,echo"
  1. 添加到Claude桌面配置:
{
  "mcpServers": {
    "command-server": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_command_server"],
      "env": {
        "ALLOWED_COMMANDS": "ls,pwd,echo"
      }
    }
  }
}

特性

  • 🔒 使用白名单安全执行命令
  • ✅ 所有命令的用户确认
  • 📝 全面的审计日志记录
  • 🔍 输入验证和净化
  • 🤖 Claude桌面集成

文档

有关完整文档,请参阅 docs/ 目录:

发展

设置

# Clone repository
git clone https://github.com/yourusername/mcp-command-server.git
cd mcp-command-server

# Create virtual environment
uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows

# Install development dependencies
uv pip install -e ".[dev]"

测试

# Run all tests
pytest

# Run specific test file
pytest tests/unit/security/test_validator.py

# Run with coverage
pytest --cov=mcp_command_server

贡献

  1. 分叉存储库
  2. 创建功能分支
  3. 运行测试和梳理
  4. 提交拉取请求

许可证

MIT许可证-请参阅 许可证 了解详情。