# aegis-x402-mcp 中文文档

规范地址：https://npmcn.com/package/aegis-x402-mcp/

版本：1\.0\.3
npm 元数据更新时间：2026-11-02T22:39:49.122Z
中文译文更新时间：2026-11-03T01:55:58.583Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/aegis-x402-mcp
原文对照：https://npmcn.com/package/aegis-x402-mcp/?lang=original
项目主页：https://github.com/Goatincrypto/aegis-x402-mcp#readme
源码仓库：https://github.com/Goatincrypto/aegis-x402-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：32.3 kB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-10-24T22:23:37.599Z
- 最新版本发布：2026-11-02T22:39:48.959Z
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

MCP服务器用于AegisAudit x402令牌安全，蜜罐模拟，KYA和PreFlight清除

## 安装

```sh
npm install aegis-x402-mcp
```

也可以使用：`pnpm add aegis-x402-mcp`、`yarn add aegis-x402-mcp`、`bun add aegis-x402-mcp`

## README

# aegis-x402-mcp

> **用于AegisAudit的模型上下文协议（MCP）服务器——自主链上令牌安全、预飞行包、KYA信誉和基于基础主网x402协议的接地AI。**

[![npm version](https://img.shields.io/npm/v/aegis-x402-mcp.svg)](https://www.npmjs.com/package/aegis-x402-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![Network: Base](https://img.shields.io/badge/Network-Base%20\(eip155%3A8453\)-0052FF)](https://base.org/) [![x402 Protocol](https://img.shields.io/badge/Protocol-x402%20v2-green)](https://x402.org/)

`aegis-x402-mcp` 将Claude Desktop， Cursor， Windsurf和自定义AI代理直接连接到实时Aegis自治节点。它使AI编码助理和交易机器人能够在部署或交易资金之前验证智能合约、测试蜜罐陷阱、评估DEX流动性并检查钱包交易对手风险。

* * *

## 工具暴露

| 工具的名字 | 价格 | 描述 |
| --- | --- | --- |
| `aegis_preflight_bundle` | **0.20美元USDC** | **杀手终点#1：** 一体化交易前清算：多oracle蜜罐审计、DEX流动性深度、交易对手KYA和AP2支出授权限制，并提供签署的执行证明。 |
| `aegis_priority_audit` | **0.05美元USDC** | 100%新鲜，未缓存的多oracle令牌安全审计绕过60秒缓存优先执行狙击手机器人。 |
| `aegis_token_audit` | **0.01美元USDC** | 多oracle智能合约字节码检测（GoPlus, Honeypot）。是DexScreener， Base RPC)。 |
| `aegis_token_preview` | **免费的** | 实时市场池、代币价格、对地址和DEX流动性，无需支付。 |
| `aegis_wallet_kya` | **0.01美元USDC** | 了解您的代理（KYA）交易对手钱包声誉，交易历史记录，余额和制裁检查。 |
| `aegis_web_scrape` | **0.005美元USDC** | 将任何公共网页转换为干净，令牌高效的LLM Markdown和提取的链接。 |
| `aegis_recent_audits` | **免费的** | Base、以太坊和Solana上最新分析代币的实时流。 |

* * *

## 快速设置

## 三层无摩擦执行架构

1.  **1层-零配置（免费层）：** 等工具 `aegis_token_preview` 和 `aegis_recent_audits` 工作立即开箱即用，零配置或密钥。
    
2.  **第2层-预付信用令牌（建议人类使用）：** 一键充值 [https://aegis-audit-x402.project-easy-x.workers.dev/pay](https://aegis-audit-x402.project-easy-x.workers.dev/pay) 获得一个签名的24小时信用令牌 `aegis_credit_...`. 添加 `AEGIS_CREDIT_TOKEN` 在你的配置中。不需要本地钱包密钥或每次呼叫签名。
    
3.  **第3层-自主代理钱包（适用于自主交易机器人和高级用户）：** 添加 `AEGIS_PRIVATE_KEY` 在你的配置中。 本地MCP客户端在MCP进程内按需在Base主网上签署无气EIP-3009微协议。钥匙永远不会离开你的机器。 **保安允许名单保安：** 客户端严格验证接收方，拒绝向除官方Aegis节点(`0x111ef680B6EFdd859FbEc473b907aCe95F0D1acB`）。
    

* * *

## 快速设置

### 选项1：克劳德桌面

将此配置添加到 `claude_desktop_config.json`：

-   **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-   **窗口:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "aegis-security": {
      "command": "npx",
      "args": ["-y", "aegis-x402-mcp"],
      "env": {
        "AEGIS_CREDIT_TOKEN": "aegis_credit_your_token_or_leave_empty_for_free_tier"
      }
    }
  }
}
```

### 选项2：游标(`.cursor/mcp.json`）

创建或更新 `.cursor/mcp.json` 在你的项目根目录下：

```json
{
  "mcpServers": {
    "aegis-security": {
      "command": "npx",
      "args": ["-y", "aegis-x402-mcp"],
      "env": {
        "AEGIS_CREDIT_TOKEN": "aegis_credit_your_token"
      }
    }
  }
}
```

### 选项3:Windsurf / Codeium

将......添加到...... `~/.codeium/windsurf/mcp_config.json`：

```json
{
  "mcpServers": {
    "aegis-security": {
      "command": "npx",
      "args": ["-y", "aegis-x402-mcp"]
    }
  }
}
```

* * *

## 环境变量

| 变量 | 描述 |
| --- | --- |
| `AEGIS_GATEWAY_URL` | 网关URL(默认为 `https://aegis-audit-x402.project-easy-x.workers.dev`）。 |
| `AEGIS_API_KEY` | 可选的开发人员API密钥，用于绕过每个调用的x402签名。 |
| `X402_PAYMENT_HEADER` | 预签名的EIP-3009支付头或授权令牌。 |

* * *

## 出版及注册登记

### 官方模型上下文协议注册表

发布在官方MCP登记处： [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/) 通过 `mcp-publisher`.

### 社区注册和发现

-   **NPM:** [https://www.npmjs.com/package/aegis-x402-mcp](https://www.npmjs.com/package/aegis-x402-mcp)
-   **GitHub:** [https://github.com/Goatincrypto/aegis-x402-mcp](https://github.com/Goatincrypto/aegis-x402-mcp)
-   **Glama:** [glama.ai / mcp /服务器](https://glama.ai/mcp/servers)
-   **PulseMCP:** [pulsemcp.com](https://pulsemcp.com/)
-   **锻冶技术:** `npx -y @smithery/cli install aegis-x402-mcp`

* * *

## 许可证

MIT©2026反重力自治系统

## 常见问题

### aegis-x402-mcp 是什么？

MCP服务器用于AegisAudit x402令牌安全，蜜罐模拟，KYA和PreFlight清除

### 如何安装 aegis-x402-mcp？

在项目目录运行 npm install aegis-x402-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 aegis-x402-mcp，可以用 npx aegis-x402-mcp 直接运行。

### aegis-x402-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### aegis-x402-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### aegis-x402-mcp 可以商用吗？

aegis-x402-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### aegis-x402-mcp 还在维护吗？

最新版本 1\.0\.3 发布于 2026/11/03（今天）；至今共发布 5 个版本，其中过去 12 个月发布了 5 个；首次发布于 2026/10/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。