macOS MCP服务器
一个安全的模型上下文协议(MCP)服务器,用于与AI助手集成的macOS命令执行。
特性
- 安全命令执行:验证并授权macOS命令执行
- 命令历史记录:持续存储和调用以前的命令
- 关键命令编辑:带有验证和警告的安全编辑界面
- 多客户端支持:同时支持Claude Code、Codex和Factory Droid
- 全面的审计日志记录:所有业务的完整审计跟踪
- 实时验证:输入净化和安全策略执行
快速开始
- 安装Rust (如果尚未安装):
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh- 克隆和构建:
git clone
cd macos-mcp-server
cargo build --release- 配置:
cp config.example.toml config.toml
# Edit config.toml to customize settings- 运行服务器:
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
