Aivory Guard

AIVory Guard 翻译为中文是“象牙卫士”或“AIV象牙防护”（具体翻译可能根据上下文或品牌含义有所调整）。不过，需要注意的是，“象牙”一词在当前保护野生动物的背景下可能引发敏感联想，因为它与非法采伐和贩卖象牙的行为有关。因此，在使用该翻译时，应确保其不会造成误解或引发不必要的争议。如果“AIVory Guard”是一个品牌或特定项目名称，建议在正式场合使用时，结合品牌或项目的具体含义进行更准确的翻译

为您的编码助手提供AI驱动的合规扫描功能

AIVory Guard 是一个 MCP（模型上下文协议）服务器，它使得像 Claude Code、Cursor 和 Windsurf 这样的 AI 编码助手能够在代码生成过程中进行实时合规性和安全性扫描。

特点/特性

• 实时安全扫描 - 在代码生成过程中捕获漏洞
• 15+项合规标准 - OWASP（开放Web应用安全项目）、GDPR（通用数据保护条例）、HIPAA（健康保险流通与责任法案）、PCI-DSS（支付卡行业数据安全标准）、SOC2（服务组织控制报告2）、ISO27001（信息安全管理体系国际标准）等更多标准
• AI驱动的分析 - 深度学习模型检测复杂的安全问题
• 快速集成 - 与任何MCP兼容的AI代理进行5分钟设置
• 零误报 - 与传统静态分析相比，AI分析减少了噪声

快速入门

先决条件

• 已安装 Node.js 18+
• AIVory 后端正在运行（参见 后端设置)
• API令牌来自AIVory

安装

# Install globally
npm install -g @aivorynet/guard

# Or use npx (no install needed)
npx @aivorynet/guard init

配置

# Run interactive setup wizard
npx @aivorynet/guard init

# Test the connection
npx @aivorynet/guard test

连接到AI代理

克劳德·科德 (~/.config/claude/mcp.json):

{
  "mcpServers": {
    "aivory": {
      "command": "npx",
      "args": ["@aivorynet/guard"],
      "env": {
        "AIVORY_API_KEY": "your_api_key_here"
      }
    }
  }
}

光标 (.cursor/mcp.json)：

{
  "mcpServers": {
    "aivory": {
      "command": "npx",
      "args": ["--yes", "@aivorynet/guard"]
    }
  }
}

使用

一旦配置完成，您的AI编码助手将自动扫描代码以检查合规性问题：

You: "Write a user authentication function in Java"

AI: [Generates code and uses AIVory Guard to scan it]

AI: "I've created the authentication function with BCrypt password hashing
     and rate limiting. The compliance scan found 0 violations - the code
     meets OWASP and GDPR standards!"

可用工具

AIVory Guard 向AI代理开放了5种MCP工具：

• scan_code - 扫描单个文件以检查合规性违规情况
• batch_scan - 高效扫描多个文件
• get_config - 获取当前合规配置
• get_rules - 列出可用的合规规则
• health_check - 验证后端连接性

后端设置

AIVory Guard 需要 AIVory Python 后端正在运行：

cd /path/to/aivory-backend
python main.py

后端运行在 http://localhost:19999 默认情况下。

获取API令牌

1. 打开 http://localhost:19999/mcp-docs
2. 填写“生成API令牌”表单
3. 复制生成的令牌
4. 跑 npx @aivorynet/guard init 并粘贴令牌

测试

测试您的设置：

npx @aivorynet/guard test

预期输出：

✅ Configuration loaded
✅ Backend is healthy
✅ Compliance scan completed

✅ All tests passed!

文档

• 开发者指南
• API 参考文档
• 故障排除

支持

• 问题https://github.com/aivorynet/aivory-guard/-/issues 翻译为中文是：“https://github.com/aivorynet/aivory-guard 项目的 Issues（问题跟踪）页面”
• 电子邮件support@aivory.net（可直接翻译为“支持邮箱：support@aivory.net”，但通常在不需要具体说明时，可简化为“邮箱：support@aivory.net”）
• 网站https://aivory.net（该网址可直接翻译为“艾弗里网”，但通常网址不直接翻译，保持原样即可）

致谢

构建于：

• 模型上下文协议（MCP）
• FastAPI
• TypeScript

______________________________________________________________________

由...用心打造 ❤️ AIVory