安全命令执行服务器

一个用于macOS的安全模型上下文协议(MCP)服务器,支持AI助手集成,提供安全的命令执行、历史记录、多客户端支持和全面的审计日志功能。

  • by hotaq
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 hotaq/Rust_mcp

使用说明

macOS MCP服务器

一个安全的模型上下文协议(MCP)服务器,用于与AI助手集成的macOS命令执行。

特性

  • 安全命令执行:验证并授权macOS命令执行
  • 命令历史记录:持续存储和调用以前的命令
  • 关键命令编辑:带有验证和警告的安全编辑界面
  • 多客户端支持:同时支持Claude Code、Codex和Factory Droid
  • 全面的审计日志记录:所有业务的完整审计跟踪
  • 实时验证:输入净化和安全策略执行

快速开始

  1. 安装Rust (如果尚未安装):

    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
    
  2. 克隆和构建:

    git clone <repository-url>
    cd macos-mcp-server
    cargo build --release
    
  3. 配置:

    cp config.example.toml config.toml
    # Edit config.toml to customize settings
    
  4. 运行服务器:

    cargo run --bin macos-mcp-server
    

配置

服务器通过以下方式配置 config.toml.关键设置包括:

  • 服务器:监听地址、客户端限制、超时
  • 安全:沙盒设置、允许的目录、阻止的命令
  • 执行:并发命令限制、资源约束
  • 历史:命令历史记录保留和搜索设置
  • 审计:日志配置和安全事件跟踪

安全特性

  • 命令验证:所有命令都根据安全策略进行验证
  • 沙箱:限制文件系统访问和进程执行
  • 授权:macOS授权服务集成
  • 审计跟踪:完整记录所有操作和安全事件
  • 风险评估:指挥风险等级的自动分类

客户端集成

克劳德代码

配置Claude Code以连接到MCP服务器:

{
  "mcpServers": {
    "macos-commands": {
      "command": "/path/to/macos-mcp-server",
      "args": ["--config", "/path/to/config.toml"]
    }
  }
}

Codex和工厂机器人

类似的配置模式也适用于其他AI客户端。

发展

建筑

cargo build
cargo build --release  # Optimized build

测试

cargo test                     # Unit tests
cargo test --test integration  # Integration tests
cargo clippy                   # Linting
cargo fmt                      # Formatting

项目结构

  • src/lib.rs -主库和服务器实现
  • src/bin/server.rs -服务器二进制入口点
  • src/mcp/ -MCP协议实现
  • src/security/ -安全验证和策略
  • src/execution/ -命令执行引擎
  • src/history/ -指挥历史和召回
  • src/tools/ -工具注册表和实现
  • src/client/ -多客户端会话管理
  • src/audit/ -综合测井系统
  • src/config/ -配置管理

许可证

MIT许可证-有关详细信息,请参阅许可证文件。

贡献

请参阅CONTRIBUTING.md了解投稿指南。#Rust_mcp