使用说明

🚀 AURA MCP 服务器

通过AURA API连接桥接大型语言模型，实现DeFi智能与链上自动化

一个可用于生产的模型上下文协议（MCP）服务器，使Claude和ChatGPT能够通过AURA API进行实时的DeFi投资组合分析、交换执行、收益机会挖掘以及跨200多个区块链网络的自动化交易策略。

🌟 特点/功能

🔄 旋转符号（表示循环、重复或刷新等意思）交换执行新

自然语言交换意图解析（“在Base上将1 ETH兑换为USDC”）
由AURA驱动的DEX聚合器（自动选择200多个链中的最佳路径）
支持900多万个代币，实时定价
基于网页的交易签名（安全浏览器签名）
代币授权管理（自动审批流程）
守卫验证（滑点、气体、风险管理）

💼 代表“公文包”或“职场/工作”的意思。投资组合管理

跨链钱包余额追踪
带有健康因子的DeFi仓位监控
实时美元价值计算
支持原生代币和ERC-20代币

🎯（目标、瞄准）运营情报 (100% 实时AURA API)

空投检测符合条件及即将进行的空投，附价值估算
清算扫描跨协议的健康因素监测
叙事机遇实时市场趋势分析
治理追踪带有投票奖励的提案检测

🤖 机器人人工智能战略自动化

DCA事件感知：结合市场事件检测的定额定期投资法（或译为：平均成本法，同时考虑市场事件）
清算守护：自动化仓位保护
篮子轮换：动态投资组合再平衡
使用复合年增长率（CAGR）、夏普比率、最大回撤进行历史回测

🛡️ 译为中文是“护盾”。这个符号通常用来表示保护、防御或安全的概念。守护引擎（风险管理）

最大滑点与燃气价格限制
允许的DEX（去中心化交易所）及被阻止的代币/协议
紧急停止功能
用户自定义的围栏设置（或：针对每个用户的可定制边界保护）

💰（钱的符号，可表示金钱或价格） x402 支付协议

链上支付验证
按请求计费（或按请求变现）
USDC/USDT支持
发票生成与追踪

🚀 快速入门

先决条件

Node.js 18及以上版本
AURA API密钥（在这里获取一个）
Git

安装

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

# Install dependencies
npm install

# Configure environment
cp env.example .env
# Edit .env and add your AURA_API_KEY

发展

# Start HTTP server (for ChatGPT/web integration)
npm run dev

# Start MCP server (for Claude Desktop)
npm run dev:mcp

# Run tests
npm test

# Build for production
npm run build

生产

# Build and start
npm run build
npm start

服务器运行于：

**Replit（注：这是一个在线代码编辑和分享平台的名称，直接翻译可能无法完全传达其含义，因此保留原英文名称）**端口 5000（自动配置）
Vercel动态端口（自动配置）
本地端口5000（默认）

⚙️ 配置

所需的环境变量

# AURA API Configuration (Required)
AURA_API_KEY=your_aura_api_key_here

# Optional Configuration
AURA_API_URL=https://aura.adex.network  # Default AURA API endpoint
MCP_SERVER_PORT=5000                     # Server port (Replit)
PORT=                                    # Dynamic port (Vercel)
NODE_ENV=production                      # Environment

可选：x402 支付配置

X402_RECEIVER=0xYourWalletAddress
X402_ASSET=USDC

🔌 与大型语言模型（LLMs）的集成

🎯（目标、瞄准、命中目标） MCP协议（原生集成）

新 AURA MCP 服务器现在支持通过 HTTP 和 SSE 实现原生 MCP 的实时双向通信！

MCP终端： https://mcp-aura.replit.app/mcp
文档： MCP_INTEGRATION.md 翻译为中文是：“MCP_集成.md”（注：这里的“md”通常表示Markdown文件格式，但在中文语境下，我们通常直接保留“md”以指明文件格式，不进行翻译）。不过，如果要更自然地表达，也可以翻译为“MCP_整合指南.md”或“MCP_集成说明.md”，具体取决于文件的实际内容和用途

ChatGPT MCP 连接器（推荐）

打开ChatGPT → 设置 → 连接器
启用开发者模式
创建新连接器：
- 名字： AURA DeFi
- 网址： https://mcp-aura.replit.app/mcp
在聊天中使用15款DeFi工具！

Claude Desktop MCP 连接器

打开设置 → 连接器
添加自定义连接器：
- 名字： AURA DeFi
- 网址： https://mcp-aura.replit.app/mcp

见 MCP_INTEGRATION.md 翻译为中文是：“MCP集成.md”（注：这里的“md”通常表示Markdown文件格式，但在中文语境下，我们通常不会特别指出文件格式，除非在需要明确说明时，所以“MCP集成”即为文件名的核心部分）以获取完整指南。

Claude Desktop（MCP 原生版）

编辑Claude配置：

# macOS/Linux
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Windows
notepad %APPDATA%\Claude\claude_desktop_config.json

添加MCP服务器：

{
  "mcpServers": {
    "aura-mcp": {
      "command": "node",
      "args": ["path/to/aura-mcp-server/dist/index.js"],
      "env": {
        "AURA_API_KEY": "your_api_key_here"
      }
    }
  }
}

重启Claude桌面版

根据提供的信息，以下是原文内容的翻译：

将服务器部署到Vercel/Replit（参见部署部分）
在ChatGPT中创建自定义GPT
使用您的服务器URL添加操作
从（某处）导入OpenAPI规范 /api/openapi.json

📖 使用示例

交换执行

// Parse natural language swap intent
const intent = await mcpClient.call('swap.parse', {
  text: 'swap 1 ETH to USDC on Base',
  userAddress: '0x69bfD720Dd188B8BB04C4b4D24442D3c15576D10'
});

// Get quote (AURA auto-selects best DEX)
const quote = await mcpClient.call('swap.quote', intent.params);

// Prepare transaction (check allowance, get tx data)
const prepared = await mcpClient.call('swap.prepare', {
  quoteId: quote.quoteId,
  userAddress: '0x69bfD720Dd188B8BB04C4b4D24442D3c15576D10'
});

// User signs transaction in browser
const signedTx = await userWallet.signTransaction(prepared.transaction);

// Execute swap
const result = await mcpClient.call('swap.execute', {
  signedTransaction: signedTx
});

投资组合分析

// Get wallet balance across chains
const balance = await mcpClient.call('portfolio.getBalance', {
  address: '0x69bfD720Dd188B8BB04C4b4D24442D3c15576D10',
  chain: 'ethereum'
});

// Get DeFi positions with health factors
const positions = await mcpClient.call('portfolio.getPositions', {
  address: '0x69bfD720Dd188B8BB04C4b4D24442D3c15576D10'
});

机会扫描

// Scan for airdrop opportunities
const airdrops = await mcpClient.call('ops.scanOpportunities', {
  kind: 'airdrop',
  params: { address: '0x69bfD720Dd188B8BB04C4b4D24442D3c15576D10' }
});

// Scan for liquidation risks
const liquidations = await mcpClient.call('ops.scanOpportunities', {
  kind: 'liquidation',
  params: { protocol: 'aave' }
});

人工智能战略自动化

// Propose DCA Event-Aware Strategy
const strategy = await mcpClient.call('strategy.propose', {
  intent: 'dca_event_aware',
  params: {
    asset: 'ETH',
    budgetUsd: 200,
    cadence: '2x/week',
    eventRules: {
      pauseOnUnlock: true,
      maxGasGwei: 25,
      boostOnDrawdownPct: 3
    }
  },
  address: '0x69bfD720Dd188B8BB04C4b4D24442D3c15576D10'
});

// Backtest strategy
const backtest = await mcpClient.call('strategy.backtest', {
  name: 'dca_event_aware',
  params: strategy.params,
  lookbackDays: 90
});

🚀 部署

部署到Vercel（推荐）

选项1：一键部署

选项2：Vercel CLI（命令行界面）

# Install Vercel CLI
npm i -g vercel

# Login and deploy
vercel login
vercel --prod

# Set environment variable
vercel env add AURA_API_KEY

选项3：GitHub集成

推送到GitHub
导入仓库至 vercel.com/new（可译为：“Vercel 新建项目页面”或保持原样作为网址）
添加 AURA_API_KEY 在环境变量中
部署

📖 书籍 详细指南查看 `VERCEL_DEPLOY.md` 翻译成中文是：`Vercel 部署指南.md` 或者 `Vercel 部署说明.md`（具体翻译可能根据上下文有所调整，但基本意思是“关于Vercel部署的指南/说明文件”）

部署到Replit

将GitHub仓库导入到Replit
添加 AURA_API_KEY 到Replit Secrets（注：Replit是一个在线编程平台，Secrets可能指的是该平台上用于存储敏感信息或环境变量的某个功能或部分）
点击运行（在5000端口上自动配置）

部署到铁路系统

npm i -g @railway/cli
railway login
railway up
railway variables set AURA_API_KEY=your_key

🏗️ 建筑学

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Claude/ChatGPT│    │  AURA MCP Server│    │    AURA API     │
│                 │◄──►│                 │◄──►│                 │
│  - Tool Calls   │    │  - MCP Protocol │    │  - Portfolio    │
│  - Responses    │    │  - Guard Engine │    │  - Swap Agg.    │
│  - Context      │    │  - x402 Paywall │    │  - Strategies   │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                                │
                                ▼
                       ┌─────────────────┐
                       │  200+ Chains    │
                       │                 │
                       │  - Ethereum     │
                       │  - Base         │
                       │  - Arbitrum     │
                       │  - Polygon      │
                       │  - Optimism     │
                       │  - And more...  │
                       └─────────────────┘

技术栈

运行时使用TypeScript的Node.js 18+
框架Fastify（HTTP），MCP SDK（标准输入输出）
验证Zod schemas（Zod模式）
测试Jest 覆盖率超过 80%
区块链Ethers.js v6
APIAURA API（https://aura.adex.network）

🧪 测试

# Run all tests
npm test

# Run with coverage
npm test -- --coverage

# Run specific test suite
npm test -- --testNamePattern="Swap Tools"

# Watch mode
npm run test:watch

📊 性能

交换报价根据上面的信息，执行如下指令：
投资组合分析链间传输时间小于2秒
策略回测90天期限内少于5秒
吞吐量每分钟100+请求
正常运行时间99.9%的SLA（Vercel/Railway）

🔒 安全

✅ 使用Zod模式进行输入验证
✅ 发动机风险管理保障
✅ 基于网页的签名（无需服务器端私钥）
✅ x402链上支付验证
✅ 限流与DDoS防护
✅ 环境变量加密

📚 API参考

MCP 工具

工具	描述	输入	输出
项目	描述	类型	数量
解析后的交换参数	`swap.quote`	`{ fromToken, toToken, amount, chain }`	获取最佳去中心化交易所（DEX）的兑换报价
带路线的报价	`swap.prepare`	`{ quoteId, userAddress }`	准备交换交易
交易数据	`swap.execute`	`{ signedTransaction }`	执行签名交换
执行结果	`portfolio.getBalance`	`{ address, chain }`	获取钱包余额
代币余额	`portfolio.getPositions`	`{ address }`	获取DeFi仓位
带有健康职位	（或更自然的表达为：“健康相关的职位”） `ops.scanOpportunities`	`{ kind, params }`	搜索机会
机会列表	`strategy.propose`	`{ intent, params, address }`	提出策略
策略提案	`strategy.backtest`	`{ name, params, lookbackDays }`	回测策略
性能指标	`transaction.simulate`	`{ intentId, txParams }`	模拟交易
模拟结果	`transaction.execute`	`{ intentId, txParams }`	执行事务
执行结果	`guard.setRules`	`{ ruleType, params }`	设置风险规则
确认	`report.get`	`{ sessionId }`	获取交易报告
损益与补仓	`system.health`	`{}`	检查系统健康状况

| 健康状况 |

HTTP 端点 /api/*所有可用的HTTP端点位于

POST /api/swap/parse ：
POST /api/swap/quote - 解析交换意图
POST /api/swap/prepare - 获取掉期报价
POST /api/swap/execute - 准备交换交易
POST /api/portfolio/balance - 执行交换
POST /api/portfolio/positions - 查询余额
POST /api/strategy/propose - 获取位置
GET /api/health - 提出策略
GET /api/system/health - 健康检查

- 系统状态

🤝 贡献（或“参与贡献”）

欢迎投稿！请按照以下步骤操作：
为仓库创建分支git checkout -b feature/amazing-feature创建特性分支 (
）git commit -m 'Add amazing feature'提交更改（
)git push origin feature/amazing-feature推送到分支（
)

打开拉取请求

**🏆 AURA API 破解马拉松（注：此处“Hackathon”直译为“破解马拉松”可能并不完全准确，因为“Hackathon”通常指的是编程或技术挑战赛，但根据原文中的“API”和语境，这里可能是一种创意或特定活动的命名，所以保留了直译，实际翻译可能需根据具体活动性质调整。）**状态

✅ 准备就绪，可投入生产

已实现的关键功能
✅ 100%实时AURA API集成（零模拟数据）
✅ 自动DEX选择下的交换执行（支持200+链，900万+代币）
✅ 基于AI的策略自动化（DCA，清算保护）
✅ 机会扫描（空投、清算、治理）
✅ x402支付协议集成
✅ 守卫发动机风险管理

✅ 克劳德（Claude）与ChatGPT的MCP协议

演示实时服务器
**[您部署的URL]**GitHub
https://github.com/aura-mcp/server 翻译为中文是：“https://github.com/aura-mcp/server（GitHub仓库地址，用于Aura模组的服务器端）”。不过，通常在中文语境下，我们可能会简化为“GitHub上的aura-mcp/server仓库”或“aura-mcp的服务器端GitHub项目”，具体取决于上下文和表达习惯文档 replit.md 见

关于技术细节

📄 许可证此项目采用MIT许可证授权 - 详见许可证

文件中详述。

📞 支持文档 :
**VERCEL_DEPLOY.md（文件名，可译为“Vercel 部署指南.md”或保持原文件名不变，根据上下文决定是否需要翻译文件名）**问题：
**GitHub 问题（或“GitHub 问题追踪”）**AURA API
**https://aura.adex.network（该网址可直接作为中文表述，无需翻译，若需说明其功能或内容，则需具体上下文来确定，此处仅提供网址本身）**MCP协议

https://modelcontextprotocol.io（中文可表述为：“模型上下文协议”官方网站，但具体翻译可能需根据网站实际内容调整）

为AURA社区倾心打造