核心用法
8004-MCP是基于ERC-8004协议的Agent Registry多链MCP服务器，为AI代理提供跨链身份注册、声誉查询与反馈管理能力。核心功能涵盖：
1. 代理发现与查询
agent_search: 支持按名称、描述、能力标签（MCP/A2A端点、技能类型）多维度搜索代理cache_search: 基于FTS5的快速模糊匹配，适合部分名称检索agent_get/reputation_get: 获取代理详情与综合信誉评分leaderboard_get: 按链查看高信誉代理排行榜
2. 代理注册与管理
agent_register: 在Solana或EVM链（ETH/Base/Arbitrum等）注册新代理NFT- 自动IPFS元数据托管，支持自定义tokenUri
- 所有权转移、URI更新等链上操作
3. 反馈与声誉系统
feedback_give: 提交0-100分评分+分类标签（uptime/quality等）- Solana特有ATOM声誉模型：质量分、信任层级、双EMA衰减机制
x402_feedback_submit: 支付凭证关联的反馈验证
4. 钱包安全架构
- 主密码加密的本地钱包存储（wallet_store_init/unlock）
- 多链钱包创建（Solana/EVM），私钥永不暴露
- 自动锁定与会话恢复机制
5. 网络与成本优化
- 一键切换testnet/mainnet，支持7+链
- 推荐L2链（Base/Arbitrum）降低成本10-100倍
- dry-run模式（skipSend）零成本预演交易
显著优点
- 跨链互操作: 统一的Global ID格式（sol:/eth:/base:），打破链间孤岛
- 标准兼容: 原生支持OASF技能标准、MCP/A2A协议、x402支付验证
- 开发者体验: TypeScript SDK完备，60+工具覆盖全生命周期，含错误码对照表
- 经济高效: L2注册成本$0.01-0.5，反馈提交$0.01-0.3，远低于ETH主网
- 安全设计: 主密码加密+自动锁定+不可恢复机制，平衡便利与资产安全
潜在局限
- 资金门槛: 代理注册/反馈需链上gas，无免费层级；测试网需人工领水（faucet需人机验证）
- 主网成本波动: ETH主网gas高峰时操作可达$10-60，需主动切换L2
- 密码风险: 主密码丢失无恢复途径，用户教育成本高
- Solana中心化依赖: ATOM声誉、验证机制依赖特定合约实现
- IPFS限制: 默认共享Pinata账户，高频使用可能触限速
适合人群
| 场景 | 推荐度 | 说明 |
|------|--------|------|
| AI Agent开发者 | ⭐⭐⭐⭐⭐ | 快速注册链上身份，建立可验证声誉 |
| 多链DeFi协议 | ⭐⭐⭐⭐⭐ | 统一查询跨链代理资质，防范恶意bot |
| 企业自动化 | ⭐⭐⭐⭐ | 内部代理市场+审计追踪，需评估主网成本 |
| 个人实验 | ⭐⭐⭐ | testnet友好，但需理解钱包/密码机制 |
| 纯链下AI应用 | ⭐⭐ | 无链上需求则过度设计 |
常规风险
资金风险: 钱包资金不足导致交易失败，需预存SOL/ETH；主网操作建议先dry-run验证。
操作风险: wallet_store_init密码务必离线备份，丢失=资产永久锁定；误删钱包无恢复。
智能合约风险: 协议依赖ERC-8004标准实现，需关注官方合约审计状态与升级公告。
网络风险: 链切换（network_set）影响所有后续操作，mainnet/testnet资产隔离需确认。
声誉操纵: 反馈系统开放，低门槛可能遭遇刷分，建议结合x402支付证明增强可信度。