athena-mcp 1.0.3 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +36 -12
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -255,23 +255,48 @@ claude mcp add athena-gev-analyzer -- python3 ~/.athena/mcp/tools/gev_analyzer.p
255
255
  ### Quick Start (after install)
256
256
 
257
257
  ```bash
258
- # Audit a Solidity contract
259
- claude "audit contracts/test-cases/Reentrancy.sol"
258
+ # 1. Configure environment for on-chain attestation + NFT minting
259
+ export SEPOLIA_PRIVATE_KEY="0x你的测试网私钥"
260
+ export SEPOLIA_RPC_URL="https://rpc.sepolia.org"
260
261
 
261
- # Full protocol audit with the agent workflow
262
- claude "read ~/.athena/AGENT-WORKFLOW-FINAL.md and audit this project"
262
+ # 2. Full audit flow (scan PoC → EAS attestation → NFT mint)
263
+ claude "audit contracts/test-cases/Reentrancy.sol and mint NFT certificate"
263
264
 
264
- # Run Slither directly
265
- python3 ~/.athena/mcp/tools/slither_runner.py
265
+ # Or just scan without on-chain steps
266
+ claude "scan contracts/test-cases/Reentrancy.sol with slither and aderyn"
266
267
  ```
267
268
 
269
+ **What happens:**
270
+ - Slither + Aderyn static analysis
271
+ - PoC generation + Foundry fuzz testing
272
+ - EAS attestation on Sepolia (on-chain audit record)
273
+ - NFT certificate minting (ERC-1155, S/A/B/C tiers)
274
+ - Verification links to Etherscan + EAS explorer
275
+
268
276
  ---
269
277
 
270
278
  ## 快速开始(中文)
271
279
 
272
- Athena 的审计流程由 AI Agent(GLM-5.1)驱动,不是简单的脚本调用。Agent 读取 `AGENT-WORKFLOW-FINAL.md`,自主执行 8 步闭环。
280
+ ### 方式一:Claude Code(推荐)
281
+
282
+ ```bash
283
+ # 1. 安装
284
+ npx athena-mcp install
285
+
286
+ # 2. 配置环境变量(用于 EAS 上链 + NFT 铸造)
287
+ export SEPOLIA_PRIVATE_KEY="0x你的测试网私钥"
288
+ export SEPOLIA_RPC_URL="https://rpc.sepolia.org"
289
+
290
+ # 3. 完整审计流程(扫描 → PoC → EAS 上链 → NFT 铸造)
291
+ claude "审计 contracts/test-cases/Reentrancy.sol 并铸造 NFT 证书"
292
+
293
+ # 或只做漏洞扫描
294
+ claude "用 slither 和 aderyn 扫描 contracts/test-cases/Reentrancy.sol"
295
+ ```
296
+
297
+ Claude Code 会自动发现并调用 13 个 MCP 工具,完成从漏洞发现到链上认证的完整闭环。
273
298
 
274
- ### 方式一:用 GLM-5.1 Agent 驱动(推荐)
299
+ ### 方式二:GLM-5.1 Agent
275
300
 
276
301
  ```bash
277
302
  # 1. 克隆项目
@@ -284,14 +309,13 @@ curl -L https://foundry.paradigm.xyz | bash # Foundry
284
309
 
285
310
  # 3. 配置环境变量
286
311
  export SEPOLIA_PRIVATE_KEY="0x你的测试网私钥"
287
- export SEPOLIA_RPC_URL="https://rpc.sepolia.org" # 或 Alchemy/Infura
312
+ export SEPOLIA_RPC_URL="https://rpc.sepolia.org"
288
313
 
289
- # 4. 用 GLM-5.1 Agent 执行审计
314
+ # 4. 用 GLM-5.1 执行
290
315
  # 将 AGENT-WORKFLOW-FINAL.md 的内容作为 prompt 发送给 GLM-5.1
291
- # Agent 会自主执行:扫描 → PoC → Fuzz → EAS 上链 → NFT 铸造
292
316
  ```
293
317
 
294
- Agent 会读取 `AGENT-WORKFLOW-FINAL.md`,按照 6 Phase 逐步执行,每一步验证通过后才继续下一步,最终输出链上验证链接和本地审计文件。
318
+ GLM-5.1 需要读取 `AGENT-WORKFLOW-FINAL.md` 作为 step-by-step 指南,Claude Code 不需要。
295
319
 
296
320
  ### 方式二:手动逐步执行
297
321
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "athena-mcp",
3
- "version": "1.0.3",
3
+ "version": "1.0.4",
4
4
  "description": "Athena — Web3 smart contract security audit MCP tools + Skills for Claude Code",
5
5
  "main": "install.js",
6
6
  "bin": {