内容
# 代理卫士 MCP 服务器
[](https://glama.ai/mcp/servers/astafford8488/agentaegis-mcp)
每项网络安全服务均可由任何 AI 代理调用，按需付费。
代理卫士是一款 MCP 服务器，允许 AI 代理按需执行网络安全操作 — 从合规性检查到漏洞扫描再到代码安全分析。它封装了最佳的开源扫描引擎（nmap、Nuclei、sslyze、Semgrep、trufflehog、trivy），并提供干净的、代理可发现的工具定义，带有结构化的输入和输出。
**第二阶段即将发布：** HTTP 传输用于远程部署，x402 微支付，API 密钥身份验证（带月度限制），Supabase 持久性，webhooks，ISO 27001 + HIPAA 框架，Railway 部署配置，以及完整的测试套件。
## 快速入门
### 本地（stdio for Claude Desktop）
```bash
git clone https://github.com/astafford8488/agentaegis-mcp.git
cd agentaegis-mcp
pnpm install
cp .env.example .env # 添加 API 密钥
pnpm build
```
添加到 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"agentaegis": {
"command": "node",
"args": ["/path/to/agentaegis-mcp/dist/index.js"],
"env": {
"NVD_API_KEY": "...",
"ABUSEIPDB_API_KEY": "...",
"OTX_API_KEY": "...",
"ABUSECH_API_KEY": "...",
"HIBP_API_KEY": "..."
}
}
}
}
```
### 远程（HTTP，用于代理平台）
```bash
# 本地开发
pnpm dev:http
# 生产环境使用 Docker
docker compose -f docker/docker-compose.yml up -d
# 生产环境使用 Railway
railway up
```
从任何 MCP 感知代理连接：
```
POST https://your-host/mcp
Authorization: Bearer aegis_<your-api-key>
```
## 架构
```
┌─────────────────────────────────────────────────────────┐
│ AI 代理（Claude，自定义 MCP 客户端） │
└────────────────┬───────────────────────┬─────────────────┘
│ stdio │ HTTP
│ │
┌────────────────▼───────────┐ ┌────────▼─────────────────┐
│ stdio 入口（index.ts） │ │ HTTP 入口（http-server）│
└────────────────┬───────────┘ └────────┬─────────────────┘
│ │
│ ┌────────────────┴─────────────┐
│ │ 身份验证网关 │
│ │ - API 密钥（数据库支持） │
│ │ - x402 微支付 │
│ └─────────────┬────────────────┘
│ │
┌────────────────▼────────────────────▼──────────────────────┐
│ MCP 服务器（server.ts） │
│ 20 个工具处理器 │
├──────────────────────────┬────────────────────────────────┤
│ 引擎包装器 │ 外部 API │
│ nmap, Nuclei, sslyze, │ NVD, AbuseIPDB, AlienVault OTX + abuse.ch, │
│ Semgrep, trufflehog, │ HIBP, Shodan │
│ trivy │ │
├──────────────────────────┴────────────────────────────────┤
│ 沙箱 │ 速率限制 │ 目标验证 │ 日志记录 │
└────────────────────────────────────────────────────────────┘
│
┌─────────▼──────────┐
│ Supabase │
│ - 客户 │
│ - API 密钥 │
│ - 扫描作业 │
│ - 使用日志 │
│ - webhooks │
└────────────────────┘
```
## HTTP API（第二阶段）
| 端点 | 方法 | 身份验证 | 描述 |
|----------|--------|------|-------------|
| `/health` | GET | 无 | 健康检查 |
| `/pricing` | GET | 无 | 工具目录及价格 |
| `/v1/customers` | POST | 无 | 创建客户账户 |
| `/v1/customers/:id/api-keys` | POST | 无 | 发行 API 密钥 |
| `/v1/customers/:id/usage` | GET | API 密钥 | 使用情况统计 |
| `/v1/jobs/:jobId` | GET | API 密钥 | 异步扫描作业状态 |
| `/mcp` | POST | API 密钥或 x402 | MCP 流式 HTTP 传输 |
### 支付流程
**选项 1：API 密钥** — 客户注册，获取密钥，通过预付余额或发票支付。每次工具调用都会从每月预算中扣除。
```bash
curl -X POST https://api.agentaegis.org/v1/customers \
-H "Content-Type: application/json" \
-d '{"email":"you@company.com","name":"Your Name"}'
curl -X POST https://api.agentaegis.org/v1/customers/<id>/api-keys \
-H "Content-Type: application/json" \
-d '{"name":"production","monthly_limit_usd":100}'
```
**选项 2：x402 微支付** — 无需注册。每次工具调用通过 USDC 在链上结算。服务器返回 `402 Payment Required` 及支付要求；客户端签名后重试，携带 `X-PAYMENT` 头部。
## 工具目录（20 个工具）
| 工具 | 类别 | 描述 | 价格 |
|------|----------|-------------|-------|
| `compliance_framework_check` | 合规性 | SOC 2, ISO 27001, HIPAA, PCI-DSS, NIST CSF 评估 | $0.50 |
| `evidence_collect` | 合规性 | 审计控制的证据收集计划 | $0.25 |
| `control_gap_analysis` | 合规性 | 优先级整改路线图 | $0.50 |
| `audit_report_generate` | 合规性 | 审计就绪的合规报告 | $1.00 |
| `policy_generate` | 合规性 | 定制的安全策略文档 | $0.50 |
| `vuln_scan_network` | 漏洞管理 | 网络端口和漏洞扫描 | $1.00 |
| `vuln_scan_web_app` | 漏洞管理 | OWASP Top 10 网络应用扫描 | $1.50 |
| `vuln_prioritize` | 漏洞管理 | 基于风险的漏洞优先级 | $0.25 |
| `cve_lookup` | 漏洞管理 | CVE 详情，CVSS，KEV 状态 | $0.10 |
| `ssl_tls_audit` | 漏洞管理 | SSL/TLS 配置审计 | $0.25 |
| `sast_scan` | 代码安全 | 静态安全分析 | $1.00 |
| `secret_scan` | 代码安全 | 硬编码秘密检测 | $0.50 |
| `dependency_audit` | 代码安全 | 依赖漏洞扫描 | $0.50 |
| `incident_triage` | 蓝队 | 事件分类和响应计划 | $0.75 |
| `threat_intel_lookup` | 蓝队 | IOC 信誉查找 | $0.25 |
| `dns_security_check` | 蓝队 | DNS 安全审计 | $0.25 |
| `email_security_audit` | 蓝队 | 电子邮件安全配置审计 | $0.50 |
| `access_review` | 身份 | 访问权限审计 | $0.50 |
| `mfa_audit` | 身份 | MFA 覆盖评估 | $0.25 |
| `credential_check` | 进攻性 | 泄露数据库查找 | $0.50 |
## 支持的合规框架
- **SOC 2 Type II** — 完整的信任服务标准（35 个控制）
- **ISO 27001:2022** — 所有 4 个附件 A 控制组（93 个控制）
- **HIPAA 安全规则** — 管理、物理和技术防护措施（43 个控制）
- **NIST CSF 2.0** — 所有 6 个功能和类别
- **PCI DSS v4.0** — 所有 12 个要求和详细控制（完整的评估逻辑）
## 开发
```bash
pnpm install # 安装依赖
pnpm dev # stdio 模式（适用于 Claude Desktop）
pnpm dev:http # HTTP 模式（带有流式 HTTP 传输）
pnpm build # 构建生产环境
pnpm test # 运行 vitest 测试套件（46 个测试）
```
## 部署
### Railway（推荐）
```bash
railway login
railway init
railway up
```
必需的环境变量（在 Railway 仪表板中设置）：
- `SUPABASE_URL`, `SUPABASE_SERVICE_KEY`
- `X402_PAYEE_ADDRESS` （您的钱包）
- `NVD_API_KEY`, `ABUSEIPDB_API_KEY`, `OTX_API_KEY`, `ABUSECH_API_KEY`, `HIBP_API_KEY`
### 数据库设置
在 Supabase SQL 编辑器中运行迁移：
```bash
cat supabase/migrations/001_initial_schema.sql
```
## 安全策略
- **目标验证**：仅限公共 IP 地址和注册域名。私有/保留范围被阻止。
- **扫描隔离**：每次扫描都在隔离进程中运行，带有临时目录清理。
- **代码安全性**：仓库克隆浅（深度=1），最大 500MB，5 分钟超时，无执行。
- **秘密隐藏**：完整秘密值从不返回 — 仅返回前 4 个和后 4 个字符。
- **速率限制**：每个 API 密钥和每个目标。最大 5 个并发扫描，每个目标每小时 10 次。
- **审计日志**：所有工具调用记录到 `usage_log`（90 天保留期）。
- **API 密钥哈希**：密钥存储为 SHA-256 哈希；原始密钥从不存储。
## 责任使用
代理卫士扫描工具只能用于您拥有或有明确书面授权测试的系统。使用此服务，您同意：
1. 您拥有系统所有者的授权，可以执行安全测试
2. 您不会将这些工具用于未经授权的访问或恶意目的
3. 您接受因您的 API 密钥发起的扫描而产生的责任
## 许可证
MIT
