PYRESEC - AI Code Security Auditing

PYRESEC — AI 代码安全引擎

通过 Base 上的 x402 USDC 微支付进行自主 SAST/SCA 安全审计。无需订阅，无需账户，只需输入代码，即可获取发现结果。

在线实例

端点	URL
首页	pyresec-agent-519576377065.us-central1.run.app
Swagger UI	/swagger
健康状态	/health
MCP 清单	/mcp/manifest.json
OpenAPI 规范	/openapi.json

---

快速开始

选项 1：x402 Python 客户端（推荐）

pip install x402

import x402

client = x402.Client(wallet_key="your-base-private-key")
response = client.post(
    "https://pyresec-agent-519576377065.us-central1.run.app/v1/audit/quick-scan",
    json={"code": "def login(u,p): return db.query(f\"SELECT * FROM users WHERE name={u} AND pass={p}\")"}
)
print(response.json())

选项 2：curl（手动 x402 流程）

# Step 1: Send request (returns 402 with payment requirements)
curl -X POST https://pyresec-agent-519576377065.us-central1.run.app/v1/audit/quick-scan \
  -H "Content-Type: application/json" \
  -d '{"code": "def login(u,p): return db.query(f\"SELECT * FROM users WHERE name={u} AND pass={p}\")"}'

# Step 2: Pay $0.01 USDC on Base using x402 protocol

# Step 3: Resubmit with X-PAYMENT header
curl -X POST https://pyresec-agent-519576377065.us-central1.run.app/v1/audit/quick-scan \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <payment-proof>" \
  -d '{"code": "..."}'

选项 3：GitHub Action（CI/CD）

- name: PYRESEC Security Scan
  uses: nanoclone-ltd/pyresec-scan-action@main
  with:
    code-path: ./src
    tier: quick-scan
    x402-wallet-key: ${{ secrets.X402_WALLET_KEY }}

选项 4：兼容 MCP 的 Agent（Claude、Cursor 等）

PYRESEC 是已注册的 MCP 工具。任何兼容 MCP 的客户端都会自动发现它：

{
  "mcpServers": {
    "pyresec": {
      "url": "https://pyresec-agent-519576377065.us-central1.run.app/mcp"
    }
  }
}

---

服务套餐

套餐	价格	端点	描述	模型
快速扫描	$0.01	POST /v1/audit/quick-scan	按严重程度排列的前 3 项发现结果、CWE ID、行号	qwen3.6-27b
深度审计	$0.50	POST /v1/audit/deep-repo	OWASP Top 10、SCA 依赖项扫描、逻辑缺陷、Gas 优化	qwen3.8-27b
修复	$5.00	POST /v1/audit/remediate	完整修补后的代码，附带变更说明和安全备注	qwen3.8-27b

---

x402 支付流程

PYRESEC 使用 x402 协议 在 Base 上进行无需许可的微支付。无需账户、API 密钥或订阅。

┌──────────┐     POST /v1/audit/quick-scan     ┌──────────┐
│  Client   │ ───────────────────────────────▶  │  PYRESEC │
│ (x402)    │ ◀──── 402 Payment Required ─────  │  Agent   │
│           │       { amount, network, to }     │          │
│           │                                   │          │
│           │ ──── X-PAYMENT (proof) ─────────▶ │          │
│           │ ◀──── 200 + Scan Results ──────── │          │
└──────────┘                                   └──────────┘

工作原理：

1. 客户端向任一审计端点发送 POST 请求
2. PYRESEC 返回 402 Payment Required，并附上支付详情（金额、收款地址、网络）
3. 客户端在 Base 主网上签署并提交 USDC 转账
4. 客户端在原始请求中添加包含支付凭证的 X-PAYMENT 标头，然后重新提交请求
5. PYRESEC 在链上验证支付并返回扫描结果

没有钱包？ 使用 x402 Python SDK 或任何兼容 x402 的客户端。

---

架构

                         ┌─────────────────────────────────┐
                         │          Client Layer            │
                         │  x402 SDK / curl / MCP Client    │
                         └──────────────┬──────────────────┘
                                        │
                              ┌─────────▼─────────┐
                              │   FastAPI Server   │
                              │   (Cloud Run)      │
                              │                    │
                              │  ┌──────────────┐  │
                              │  │ x402 Payment │  │
                              │  │  Middleware   │  │
                              │  └──────┬───────┘  │
                              └─────────┼──────────┘
                                        │
                    ┌───────────────────┼───────────────────┐
                    │                   │                   │
          ┌─────────▼─────────┐ ┌───────▼───────┐ ┌───────▼───────┐
          │  Agent Controller │ │  Population   │ │   Wallet      │
          │  (SAST + LLM)     │ │  Controller   │ │  Interface    │
          └─────────┬─────────┘ └───────────────┘ └───────────────┘
                    │
          ┌─────────▼─────────┐
          │   Groq LLM        │
          │   (qwen models)   │
          └─────────┬─────────┘
                    │
          ┌─────────▼─────────┐
          │  Security Findings │
          │  JSON Response     │
          └───────────────────┘

---

支持的漏洞类型

#	类型	CWE	严重程度
1	SQL 注入	CWE-89	HIGH
2	跨站脚本（XSS）	CWE-79	HIGH
3	命令注入	CWE-78	CRITICAL
4	路径遍历	CWE-22	MEDIUM
5	硬编码密钥	CWE-798	CRITICAL
6	弱加密	CWE-327	MEDIUM
7	SSRF	CWE-918	HIGH
8	不安全的反序列化	CWE-502	HIGH
9	身份验证绕过	CWE-287	CRITICAL
10	输入验证不当	CWE-20	MEDIUM

---

面向 AI Agent（MCP 集成）

任何兼容 MCP 的 Agent 都可以发现 PYRESEC。当 Agent 需要审计代码时，可以通过以下方式自动找到 PYRESEC：

• MCP 注册表：registry.modelcontextprotocol.io
• Smithery.ai：smithery.ai/server/@renaat-s/pyresec-agent
• 直接清单：/mcp/manifest.json

工具定义

工具	描述	费用
quick_scan	快速 SAST 扫描，按严重程度排列的前 3 项发现结果，附带 CWE ID	$0.01 USDC
deep_audit	完整 OWASP Top 10、SCA、逻辑缺陷、Gas 优化	$0.50 USDC
remediate_code	自动修补代码并附带变更说明，可直接用于 PR	$5.00 USDC

Agent 发现流程

1. Agent queries MCP Registry for "security audit" tools
2. PYRESEC appears in results with tool schemas
3. Agent calls quick_scan with source code
4. PYRESEC returns 402 with x402 payment requirements
5. Agent's x402 wallet pays USDC on Base
6. Agent resubmits with payment proof
7. PYRESEC returns findings as structured JSON

---

自我维持的 Agent

PYRESEC 在 Base 主网上作为自主 Agent 运行：

• 心跳：每 30 min — 检查余额并报告运行状况
• 终止 — 余额低于 $0.05 时关闭
• 复制 — 余额超过 $20 时，将 50% 的盈余发送到开发钱包
• 紧急停止开关 — 管理员可以远程停止所有实例

---

部署

Docker

docker build -t pyresec-agent .
docker run -p 8080:8080 --env-file .env pyresec-agent

Google Cloud Run

gcloud run deploy pyresec-agent \
  --source . \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated \
  --set-env-vars "CDP_WALLET_SECRET=$CDP_WALLET_SECRET,GROQ_API_KEY=$GROQ_API_KEY"

---

公司

NanoClone Life Sciences Ltd.（英国） 网站：nanoclonesystems.com

许可证

专有。详情请参阅 LICENSE。