AIShield

   ██████╗██╗   ██╗██████╗ ███████╗██████╗ ███████╗███████╗ ██████╗
  ██╔════╝╚██╗ ██╔╝██╔══██╗██╔════╝██╔══██╗██╔════╝██╔════╝██╔════╝
  ██║      ╚████╔╝ ██████╔╝█████╗  ██████╔╝███████╗█████╗  ██║
  ██║       ╚██╔╝  ██╔══██╗██╔══╝  ██╔══██╗╚════██║██╔══╝  ██║
  ╚██████╗   ██║   ██████╔╝███████╗██║  ██║███████║███████╗╚██████╗
   ╚═════╝   ╚═╝   ╚═════╝ ╚══════╝╚═╝  ╚═╝╚══════╝╚══════╝ ╚═════╝
              Security · Identity · Collaboration · Trust

核心特性

🛡️ 133 条安全扫描规则 — 对齐 OWASP MCP Top 10 (2025 v0.1)，覆盖 Prompt 注入、越权访问、数据泄露、协议攻击、供应链风险 5 大安全维度

🧠 智能 Prompt 注入检测 — 原生支持中文检测，识别拼音变体、谐音替换、拆字攻击等本土化绕过手法

🪪 Agent 身份系统 — DID 去中心化身份生成、多级信誉评分、API Key 生命周期管理、完整审计日志链

🤝 Agent 协作通信 — 内置发布/订阅消息总线、协作会话管理、跨 Agent 任务委托，让 Agent 之间安全对话

📦 安全沙箱执行 — 代码预检查拦截危险模式，支持 Python / JavaScript / Shell 多语言隔离执行，结果自动安全审查

🏪 技能市场 — 技能发布、搜索与调用一体化，内置评分系统，支持 HTTP RPC 真实调用验证

🔗 A2A 协议网关 — 兼容 Google A2A 协议，Agent Card 注册与发现，智能任务路由与跨 Agent 调度

💳 支付与计费 — API 按量计费、套餐管理、使用量统计，为 Agent 经济提供基础设施

🏆 安全认证徽章 — 扫描通过自动签发认证，生成可嵌入 GitHub README 的 SVG 徽章，金 / 银 / 铜三级

Related MCP server: MCPAmpel

为什么选择 AIShield

AIShield 不只是一个扫描器 — 它是 AI Agent 安全生态的完整基础设施。

快速开始

1. 克隆并启动

git clone https://github.com/lm203688/aishield.git
cd aishield
python api/server.py

服务启动后访问 http://localhost:8450，即可看到 API 信息面板。

2. 注册获取 API Key（送 100 积分）

curl -X POST https://aishield.tools/api/v1/account/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Your Name",
    "email": "your@email.com",
    "password": "YourSecurePassword123"
  }'

注册成功返回 api_key，后续调用需要携带 Authorization: Bearer YOUR_API_KEY。

3. 首次安全扫描

curl -X POST https://aishield.tools/api/v1/audit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_name": "my-agent-tool",
    "description": "A tool that executes user-provided code",
    "input_schema": {"type": "object", "properties": {"code": {"type": "string"}}},
    "endpoint": "https://example.com/api/tool"
  }'

💡 未注册用户也可匿名免费扫描 50 次/天，注册后获 100 积分（可扫描 100 次），查看定价。

4. 获取安全徽章

扫描通过后，在项目 README 中嵌入你的安全徽章：

![AIShield Security](https://aishield.tools/badge/my-agent-tool)

部署后替换 localhost:8450 为你的公网地址即可在 GitHub 中展示。

MCP 集成

AIShield 可作为 MCP Server 直接集成到 Claude Desktop、Cursor 等支持 MCP 的客户端中。

Claude Desktop

在 Claude Desktop 配置文件中添加：

{
  "mcpServers": {
    "aishield": {
      "command": "python",
      "args": ["-m", "api.mcp_server"],
      "cwd": "/path/to/aishield"
    }
  }
}

Cursor / 其他 MCP 客户端

同样在 MCP 配置中添加以上内容，即可在对话中直接调用 AIShield 的全部安全扫描能力。

集成后你可以直接在对话中说：

"帮我扫描这个 MCP 工具是否存在 Prompt 注入风险"

"检查这段文本是否包含违禁词"

API 文档

服务启动后访问 http://localhost:8450 获取完整 API 信息。核心端点包括：

安全扫描

Agent 生态

项目架构

graph TB
    subgraph Clients["客户端"]
        MCP["MCP 客户端<br/>(Claude / Cursor)"]
        SDK["HTTP 客户端 / SDK"]
    end

    subgraph Server["AIShield Server (Port 8450)"]
        API["REST API<br/>ThreadingMixIn 并发"]
        MCPE["MCP Endpoint<br/>StreamableHTTP"]

        subgraph Scanner["安全扫描引擎"]
            PE["Prompt 注入检测"]
            MW["零宽字符检测"]
            RP["Rug Pull 检测"]
            AS["API 安全扫描"]
            BW["违禁词检测"]
            SC["5 维评分引擎<br/>133 条规则"]
        end

        subgraph Eco["生态模块"]
            ID["Agent DID<br/>身份系统"]
            RP2["信誉评分"]
            CO["协作通信总线"]
            SB["安全沙箱"]
            MK["技能市场"]
            A2A["A2A 协议网关"]
            PAY["支付与计费"]
            BD["认证徽章"]
        end
    end

    MCP --> MCPE
    SDK --> API
    MCPE --> Scanner
    API --> Scanner
    API --> Eco
    Scanner --> SC
    SC --> BD

技术特点：

• 零依赖架构 — 纯 Python 标准库实现，无需 pip install 任何第三方包

• ThreadingMixIn 并发 — 内置线程池处理，支持多请求并行

• JSON 文件存储 — 轻量持久化，线程安全，开箱即用

• OWASP API Security 映射 — 9 大安全类别全覆盖

• 中文违禁词引擎 — 覆盖微信、抖音、小红书、B 站、微博 6 大平台

安全认证徽章

AIShield 为通过安全扫描的工具自动签发可嵌入的 SVG 徽章，让你的项目安全状态一目了然。

徽章等级

在你的项目中使用

在你的 README.md 中添加以下代码：

<!-- AIShield Security Badge -->
![AIShield Verified](https://your-aishield-domain.com/badge/your-tool-name)

AIShield 会根据最新扫描结果动态渲染徽章颜色和状态。

路线图

Phase 1 — 安全扫描引擎 ✅ (当前)

• 133 条 OWASP MCP Top 10 对齐检测规则

• 5 维安全评分引擎

• 中文 Prompt 注入检测（拼音 / 谐音 / 拆字）

• 零宽字符 / 隐写术 / Rug Pull 检测

• 违禁词检测（6 大中文平台）

• MCP Server 模式 + StreamableHTTP

• 代理调用网关

Phase 2 — 信任生态

• Agent DID 身份注册与跨链验证

• 多级信誉系统上线

• 安全徽章签发平台

• 技能市场 Beta

• A2A 协议网关完善

• 按量计费与配额管理

Phase 3 — 规模化治理

• 多租户支持与企业 SSO

• 社区贡献规则市场

• AI 驱动的规则自动生成

• Web Dashboard 可视化管理

• 国际化 (i18n) 多语言支持

• SLA 监控与告警

贡献指南

我们欢迎任何形式的贡献，包括但不限于：新检测规则、Bug 修复、文档改进、功能建议。

参与步骤

1. Fork 本仓库

2. 创建特性分支：git checkout -b feature/your-feature-name

3. 提交变更：git commit -m 'feat: add xxx feature'

4. 推送分支：git push origin feature/your-feature-name

5. 提交 Pull Request

提交规范

使用 Conventional Commits 格式：

• feat: 新功能

• fix: Bug 修复

• docs: 文档变更

• refactor: 代码重构

• test: 测试相关

• chore: 构建 / 工具链变更

贡献检测规则

在 scanner/rules.py 中添加新规则，确保与 OWASP MCP Top 10 分类对齐。提交 PR 前运行测试：

python tests/quick_test.py

部署

AIShield 支持多种部署方式：

直接运行：

python api/server.py

Docker：

docker build -t aishield .
docker run -p 8450:8450 aishield

Railway / Render：

项目内置 railway.json、render.yaml 和 Procfile，可直接一键部署。

详见 DEPLOY.md。

🚀 立即开始

选择最适合你的方式开始使用 AIShield：

致谢

• OWASP MCP Security Top 10 — 安全标准与规则体系

• Google A2A Protocol — Agent-to-Agent 通信协议参考

• MCP Community — Model Context Protocol 社区生态

• 所有为 AIShield 贡献代码和规则的 Contributors

许可证

MIT License © 2025 AIShield Contributors