AI导哈

策略执行服务

MCP Server作为策略守门员，实时拦截和验证AI编码代理的行为，防止违反组织标准。

  • by GILSMON
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 GILSMON/mcpServer_as_gatekeeper

使用说明

MCP服务器作为策略守护者

使用模型上下文协议对AI编码代理实施实时策略执行

在执行前拦截并验证人工智能代理的行为，以防止其违反组织标准。

🎯 问题

AI编码助手可以绕过：

  • 命名规范（驼峰命名法 vs 下划线命名法）
  • 安全策略（代码中的秘密、破坏性命令）
  • 合规规则（文件访问、API使用）

传统解决方案（持续集成/持续交付，代码审查）能够发现违规行为 之后 已经造成了损害。

✨ 解决方案

作为……的MCP服务器 政策把关人 - 实时验证每个代理的操作：

Agent: "Create myFirst--File.txt"
   ↓
MCP Server: ❌ Violates snake_case policy
   ↓
Agent: "Creating my_first_file.txt instead"

🚀 快速入门

# Clone & setup
git clone https://github.com/yourusername/mcpServer_as_gatekeeper.git
cd mcpServer_as_gatekeeper

# Install with uv
uv init
uv add mcp

# Run server
uv run server.py

🔧 风帆冲浪集成

添加到 ~/.windsurf/mcp_config.json：

{
  "mcpServers": {
    "policy-gatekeeper": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcpServer_as_gatekeeper",
        "run",
        "server.py"
      ]
    }
  }
}

重启风帆冲浪（或：重启帆板系统）。完成。

📋 内置策略

1. 命令验证

  • ❌ 阻塞： rm -rf /， curl | bash， chmod 777
  • ✅ 允许： git， npm， docker，安全操作

2. 文件命名

  • 强制执行： snake_case 对于文件
  • 废品/不合格品： camelCase， kebab-case，特殊字符

3. 敏感路径

  • 区块： /etc/shadow， .ssh/id_rsa， .env 文件

4. 网络安全

  • 防止：命令注入、数据外泄

🧪 测试它

提示您的代理：

Create a file called myTest--File.txt

预期： 代理自动更正为 my_test_file.txt

Validate this command: rm -rf /

预期： 因违反政策而被屏蔽 ORG-SEC-001

📊 功能特性

特性 状态
命令验证 ✅
文件命名强制执行 ✅
审计日志 ✅
统计信息仪表板 ✅
OPA 集成 🔄 路线图
秘密扫描 🔄 路线图

🏗️ 建筑学

┌─────────────────┐
│  AI Agent       │
│  (Windsurf)     │
└────────┬────────┘
         │ MCP Protocol
         ↓
┌─────────────────────────┐
│  Policy Gatekeeper      │
│  - Validate command     │
│  - Check naming rules   │
│  - Scan for secrets     │
│  - Audit log            │
└────────┬────────────────┘
         │
         ↓
    ALLOW / DENY

🎛️ 自定义策略

编辑 server.py：

POLICY_RULES = {
    "your_rule": {
        "patterns": [r"your_regex"],
        "message": "Your policy message"
    }
}

重启MCP服务器。策略立即更新。

📈 规模影响

对于一个50人开发团队：

  • 5000 每日政策检查（每位开发者100次）
  • 每周约100小时 节省了人工执行的成本/精力
  • 80% 在代码审查前预防的违规行为
  • 零 因违反策略导致的CI构建失败

🔐 企业用例

  • 安全： 屏蔽秘密信息，恶意命令
  • 合规性： 强制执行SOC2/HIPAA文件访问规则
  • 质量： 命名一致，代码结构清晰
  • 成本： 防止昂贵的CI/CD（持续集成/持续交付）失败

🛣️ 路线图

  • [ ] 复杂策略的OPA/Rego集成
  • [ ] 密码检测（集成TruffleHog）
  • [ ] RBAC（基于角色的验证）
  • [ ] 多团队策略联邦
  • [ ] VS Code / Cursor 支持
  • [ ] 政策管理的仪表板用户界面

🤝 贡献（或“参与贡献”）

有政策模式要分享吗？欢迎提交拉取请求（PR）！

  1. 为该仓库创建分支（或：为该代码库进行 Fork）
  2. 将您的政策添加到 POLICY_RULES
  3. 添加测试用例
  4. 提交拉取请求（或：提交合并请求）

📄 许可证

麻省理工学院（MIT）

相关 MCP