使用说明

🚀 AURA MCP服务器

人工智能驱动的DeFi投资组合分析和代币交换平台

一个生产就绪的REST API服务器，使ChatGPT和人工智能助手能够与AURA API交互，以进行实时DeFi投资组合分析、人工智能策略建议和200多个区块链网络上的去中心化代币交换。

🌟 特性

🔄 代币交换（0x DEX聚合）

多链支持：以太坊、Base、Polygon、Arbitrum、Optimism、Base Sepolia
MetaMask浏览器钱包集成，用于安全交易签名
100多个流动性来源的API DEX合计
防护发动机验证（滑移限制、气帽）
基于Web的交换界面 /swap
实时报价和路线优化

💼 投资组合管理（澳大利亚石油学会API）

200多个区块链网络的实时钱包余额
跨链DeFi位置监测
900万+代币支持下的美元价值计算
原生代币和ERC-20支持

🤖 人工智能战略建议（澳大利亚石油学会API）

DCA事件感知：通过市场事件检测进行美元成本平均
Liquidation Guard：自动头寸保护策略
篮子轮换：动态投资组合再平衡
基于投资组合分析的人工智能战略建议

🛡️ 防护引擎（风险管理）

可配置的滑点限制和天然气价格上限
执行前交换报价验证
紧急停止能力
每个用户可定制的安全规则

⚡ 系统健康监测

实时服务器状态和正常运行时间跟踪
部件健康检查
API端点诊断

🚀 快速开始

先决条件

Node.js 18+
AURA API密钥(联系AdEx网络)
0x API密钥(获取免费套餐)

安装

# Clone repository
git clone https://github.com/aura-mcp/server.git
cd aura-mcp-server

# Install dependencies
npm install

# Configure environment secrets in Replit
# Add: AURA_API_KEY and ZEROEX_API_KEY

发展

# Start HTTP server (Replit)
npm run dev

# Build for production
npm run build

# Start production server
npm start

服务器在上运行 端口5000 （已配置为Replit）

⚙️ 配置

所需的环境变量

# AURA API Configuration (Required)
AURA_API_KEY=your_aura_api_key_here

# 0x Swap API Configuration (Required for swap features)
ZEROEX_API_KEY=your_0x_api_key_here

# Optional Configuration
AURA_API_URL=https://aura.adex.network  # Default AURA API endpoint
PORT=5000                                 # Server port
NODE_ENV=production                       # Environment

📖 使用示例

令牌交换（浏览器界面）

打开 /swap 在浏览器中
连接MetaMask钱包
选择网络（基础、以太坊、多边形等）
输入令牌地址和金额
获取报价并执行掉期

投资组合分析（API）

# Get wallet balance across all chains
curl -X POST http://localhost:5000/api/portfolio/balance \
  -H "Content-Type: application/json" \
  -d '{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'

# Response: Portfolio with USD valuations across 200+ chains

代币交换（API）

# Get supported networks
curl http://localhost:5000/api/swap/chains

# Prepare swap transaction (ETH → USDC on Base)
curl -X POST http://localhost:5000/api/swap/prepare \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": 8453,
    "sellToken": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    "buyToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "sellAmount": "10000000000000000",
    "taker": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  }'

# Response: Transaction data ready for MetaMask signing

人工智能战略建议（API）

# Get DCA strategy proposal
curl -X POST http://localhost:5000/api/strategy/propose \
  -H "Content-Type: application/json" \
  -d '{
    "intent": "dca_event_aware",
    "params": {
      "asset": "ETH",
      "budgetUsd": 1000,
      "cadence": "weekly"
    },
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  }'

# Response: AI-powered strategy with AURA recommendations

防护发动机配置

# Set risk management rules
curl -X POST http://localhost:5000/api/guard/setRules \
  -H "Content-Type: application/json" \
  -d '{
    "rules": {
      "risk": {
        "maxSlippagePct": 1.0,
        "maxGasGwei": 100
      }
    }
  }'

# Enable emergency stop
curl -X POST http://localhost:5000/api/guard/setEmergencyStop \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

🏗️ 建筑

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   ChatGPT / AI  │    │  AURA MCP Server│    │    AURA API     │
│                 │◄──►│                 │◄──►│                 │
│  - HTTP Calls   │    │  - Fastify API  │    │  - Portfolio    │
│  - Responses    │    │  - Guard Engine │    │  - Strategies   │
│                 │    │  - Swap Adapter │    │  - AI Insights  │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                                │
                                ▼
                       ┌─────────────────┐
                       │   0x Swap API   │
                       │                 │
                       │  - DEX Agg.     │
                       │  - Quote        │
                       │  - 100+ DEXes   │
                       └─────────────────┘
                                │
                                ▼
                       ┌─────────────────┐
                       │  200+ Chains    │
                       │                 │
                       │  - Ethereum     │
                       │  - Base         │
                       │  - Arbitrum     │
                       │  - Polygon      │
                       │  - Optimism     │
                       └─────────────────┘

技术栈

运行时：Node.js 18+与TypeScript
框架：Fastify（HTTP服务器）
验证：用于类型安全的Zod模式
区块链：Ethers.js v6
应用程序编程接口:
- API澳大利亚石油管理局(https://aura.adex.network)-投资组合和策略
- 0x API(https://api.0x.org)-DEX聚合
前端：集成MetaMask的Vanilla JS
日志记录：Winston用于结构化日志

📚 api参考

HTTP端点

投资组合端点

POST /api/portfolio/balance -获取所有链上的钱包余额
POST /api/portfolio/positions -获取具有健康因素的DeFi位置

交换端点

GET /api/swap/chains -获得支持的网络（6条链）
POST /api/swap/quote -从0x API获取交换报价
POST /api/swap/price -获取价格估算（详细）
POST /api/swap/prepare -准备交易以供签署
GET /api/swap/sources/:chainId -获取链的DEX来源

战略终点

POST /api/strategy/propose -获取人工智能战略建议

保护端点

POST /api/guard/setRules -配置风险管理规则
POST /api/guard/setEmergencyStop -启用/禁用紧急停止

系统端点

GET /api/health -正常运行时间的健康检查

web界面

GET / -带有功能概述的登录页面
GET /swap -与MetaMask集成交换接口

🧪 测试

所有功能都经过测试和验证：

✅ 200多条链的投资组合平衡
✅ 具有0x API（ETH）的代币交换报价→ 美元兑美元基准）
✅ 防护发动机验证（打滑和气体限制）
✅ 与MetaMask集成交换接口
✅ AURA API人工智能战略建议

# Test portfolio endpoint
curl -X POST http://localhost:5000/api/portfolio/balance \
  -H "Content-Type: application/json" \
  -d '{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'

# Test swap chains
curl http://localhost:5000/api/swap/chains

# Test swap quote (requires taker address)
curl -X POST http://localhost:5000/api/swap/prepare \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": 8453,
    "sellToken": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    "buyToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "sellAmount": "10000000000000000",
    "taker": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
  }'

📊 演出

交换报价：<300ms（0x API聚合）
投资组合分析：200多条链中<2s
战略建议：约30秒（人工智能推荐）
吞吐量：100+个请求/分钟
运行时间：回复率为99.9%

🔒 安全

✅ 使用Zod模式进行输入验证
✅ 保护发动机风险管理（打滑、气体限制）
✅ MetaMask浏览器签名（无服务器端私钥）
✅ CORS已启用，可实现安全的钱包连接
✅ 环境变量加密（Replit Secrets）
✅ TypeScript类型安全

🚀 部署

答复（当前部署）

将GitHub存储库导入到Replit
在“答复机密”中添加机密：
- AURA_API_KEY
- ZEROEX_API_KEY
单击运行（在端口5000上自动配置）
通过您的回复URL访问

手动部署

# Build production bundle
npm run build

# Start production server
npm start

默认情况下，服务器将在端口5000上运行。

📄 技术文档

有关详细的技术文档、架构决策和实施细节，请参阅：

replit.md -完整的技术文档
package.json -依赖关系和脚本

🤝 贡献

欢迎投稿！请按照以下步骤操作：

复刻仓库
创建特征分支(git checkout -b feature/amazing-feature)
提交更改(git commit -m 'Add amazing feature')
推送到分支(git push origin feature/amazing-feature)
打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。

📞 支持

文档: replit.md
问题: GitHub问题
API澳大利亚石油管理局: https://aura.adex.network
0x API: https://0x.org/docs

内置于❤️ 对于DeFi

由AURA API提供支持•0x协议•Web3