AI导哈

去中心化交易所服务器

Byreal MCP Server 是一个为Solana链上集中流动性做市商（CLMM）提供CEX级别流动性的去中心化交易所服务器，支持AI代理通过模型上下文协议（MCP）工具进行操作。

  • by Stanleylee01
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Stanleylee01/byreal-mcp

使用说明

Byreal MCP服务器v0.6.2

MCP服务器 拜雷尔DEX --Solana CLMM具有CEX级流动性。

通过以下方式将所有Byreal操作作为MCP工具公开给AI代理 模型上下文协议.

41工具 涵盖：池、掉期、头寸、流动性管理、复制农业、市场数据、订单、代币、带自动签名的钱包管理，以及 智能分析工具.

v0.6的新增功能

  • byreal_pool_analyze --具有风险因素和投资预测的多范围APR分析
  • byreal_position_analyze --使用池上下文丰富功能进行位置健康检查
  • byreal_easy_swap --人性化交换： fromToken="SOL" toToken="USDC" amount="1.5" --一个电话确实需要报价+签名+发送
  • amountUsd 模式 --通过以下方式打开或复制职位 amountUsd=100 --根据当前价格和范围自动计算代币A/B分割
  • dryRun 模式 --预览任何交换而不执行： dryRun=true
  • 错误恢复建议 --上下文感知 💡 Suggestions 每一个错误（平衡不足→ 检查钱包，滑点→ 增加bps等）
  • byreal_catalog --代理自我发现：按关键字搜索工具
  • 扩展CopyFarmer — top_positions 使用sortField/状态过滤器， farmer_positions, top_farmers
  • keypairPath 钱包 --使用现有的Solana密钥对文件，而不是生成新的密钥对文件

快速开始

与Claude Code一起使用

# 1. Clone & install
git clone https://github.com/Stanleylee01/byreal-mcp.git
cd byreal-mcp && npm install && npm run build

# 2. Configure RPC (get free Helius API key: https://helius.dev)
bash scripts/setup.sh

# 3. Register as MCP server in Claude Code
claude mcp add byreal -- node $(pwd)/dist/index.js

# 4. Restart Claude Code → 41 tools available
# Say "帮我创建钱包" to get started

与光标一起使用

添加 .cursor/mcp.json:

{
  "byreal": {
    "command": "node",
    "args": ["/path/to/byreal-mcp/dist/index.js"]
  }
}

与mcporter（OpenClaw）一起使用

mcporter config add byreal --stdio "node ~/clawd/byreal-mcp/dist/index.js"
mcporter list byreal    # should list 41 tools
mcporter call byreal.byreal_global_overview

钱包设置（可选-启用写入操作的自动签名）

# Option A: Generate new keypair
# In Claude Code just say "帮我创建钱包" or call byreal_wallet_setup

# Option B: Use existing keypair file
# Edit ~/.byreal-mcp/wallet.json:
# { "keypairPath": "/path/to/your/id.json" }

# ⚠️ Back up your wallet — losing it = funds are unrecoverable

只读工具无需钱包配置即可工作。 钱包仅用于交换/LP/复制操作。

环境变量

变量 默认值 描述
BYREAL_API_BASE https://api2.byreal.io/byreal/api Byreal REST API基础URL
SOL_RPC https://api.mainnet-beta.solana.com Solana RPC端点
SOL_ENDPOINT （与SOL_RPC相同） SDK脚本接受的别名
HTTPS_PROXY （未设置） SDK子进程调用的HTTP代理（中国需要）

工具（共41个）

游泳池（5）

工具 说明
byreal_list_pools 按TVL、交易量、费用或APR排序的池列表
byreal_pool_info 按地址获取一个或多个池的信息
byreal_pool_details 价格变动的综合单池详情
byreal_pool_live_price 通过路由器获取任何代币对的实时价格
byreal_pool_analyze 新 多区间APR分析、风险因素、投资预测

交换（3）

工具 说明
byreal_swap_quote 无需钱包即可获取报价（原始灯口金额）
byreal_swap_transaction 构建未签名的交换tx（原始灯口、手动签名）
byreal_easy_swap 新 人性化交换 dryRun 模式+错误建议

职位--阅读（8）

工具 说明
byreal_list_positions 列出带有PnL摘要的钱包的所有LP头寸
byreal_position_analyze 新 使用池上下文丰富功能进行位置健康检查
byreal_calculate_apr 估算假设存款的年利率
byreal_position_detail 特定职位地址的详细信息
byreal_position_overview 钱包的汇总头寸统计数据
byreal_position_pnl 详细的PnL明细（存款、费用、奖励、奖金）
byreal_unclaimed_fees 在不收集的情况下检查可索赔的内容
byreal_create_position_info 开盘前预览代币金额

流动性——写（8）

工具 说明
byreal_open_position 打开新的CLMM位置。支持 amountUsd 自动拆分
byreal_close_position 关闭头寸，清除所有流动性
byreal_add_liquidity 向现有头寸添加更多代币
byreal_remove_liquidity 移除流动性的N%
byreal_submit_liquidity_tx 广播签名流动性交易
byreal_collect_fees_tx 建立交易平台以收取交易费用
byreal_claim_rewards_tx 创建tx以领取激励奖励
byreal_submit_claim 提交已签名的奖励申请tx

CopyFarmer（5）

工具 说明
byreal_top_farmers 顶级LP农民排行榜
byreal_top_positions 使用sortField（流动性/apr/收益/pnl/副本）+状态过滤器的顶级头寸
byreal_farmer_positions 特定农民的所有职位
byreal_copyfarmer_overview 全球CopyFarmer计划统计数据
byreal_copy_position 模仿农民的立场。支持 amountUsd 自动拆分

市场数据（6）

工具 说明
byreal_global_overview DEX范围内的TVL、交易量、费用（24小时+全时）
byreal_mint_prices 批量美元价格查询（最多20个代币）
byreal_mint_list 搜索/列出Byreal上的所有代币
byreal_hot_tokens 趋势代币
byreal_kline K线（OHLCV）烛台数据
byreal_dynamic_fee 当前动态费率

订单（2）

工具 说明
byreal_order_history 钱包的掉期/交易订单历史记录
byreal_list_orders 列出当前有效的限价订单

代币（3）

工具 说明
byreal_token_price 按符号或造币厂显示的实时美元价格
byreal_market_overview 快速价格快照：SOL、bbSOL、USDT
byreal_known_tokens 列出已知的造币厂地址和小数

钱包（3）

工具 说明
byreal_wallet_setup 生成本地Solana密钥对
byreal_wallet_status 检查地址，SOL/USDC余额
byreal_sign_and_send 签署未签名的tx+广播到Solana

发现（1）

工具 说明
byreal_catalog 列出所有带有描述的工具。按关键字搜索。

主要特点

amountUsd模式（v0.6）

代替手动计算代币金额：

byreal_open_position({
  poolAddress: "...",
  priceLower: "80", priceUpper: "90",
  amountUsd: 100,      // ← invest $100, auto-split A/B
  userAddress: "..."
})

工作为 open_position 和 copy_position。自动从池详细信息中获取当前价格。

dryRun模式（v0.6）

预览任何交换而不执行：

byreal_easy_swap({
  fromToken: "SOL", toToken: "USDC", amount: "1.5",
  dryRun: true          // ← quote only, no tx
})

错误恢复建议（v0.6）

每个错误都包括可操作的后续步骤：

❌ Execution failed: insufficient funds
💡 Suggestions:
  • Check balance: byreal_wallet_status
  • You may need more SOL for gas
  • Try a smaller amount

自动签名模式

配置钱包后，写工具会自动签名并广播：

byreal_easy_swap → quote → sign with local keypair → broadcast → {signature, explorerUrl}

复制农场

1. byreal_top_positions → find top farmer by earned/pnl
2. byreal_copy_position → replicate their tick range with amountUsd

插入 REFERER_POSITION 链上副本奖金跟踪备忘录。

建筑

byreal-mcp/
├── src/
│   ├── index.ts              — MCP server entry, transport, tool registration
│   ├── config.ts             — Chain client, API endpoints, fetch helpers
│   ├── wallet.ts             — Keypair management, signing, balance queries
│   └── tools/
│       ├── pools.ts          — Pool queries + pool_analyze
│       ├── swap.ts           — Swap quote + easy_swap with dryRun
│       ├── positions.ts      — Position list + position_analyze
│       ├── liquidity.ts      — Open/close/add/remove + copy with amountUsd
│       ├── copyfarmer.ts     — Top farmers, top positions, farmer overview
│       ├── market.ts         — Global overview, prices, klines, dynamic fees
│       ├── orders.ts         — Order history
│       ├── tokens.ts         — Token prices, known tokens
│       ├── wallet.ts         — Wallet tool definitions
│       └── catalog.ts        — Tool discovery catalog
├── sdk-ref/                  — @byreal/clmm-sdk (DO NOT MODIFY)
│   └── src/scripts/          — SDK scripts for building transactions
├── scripts/
│   └── setup.sh              — One-line config setup
├── dist/                     — Compiled JS (npm run build)
└── package.json

关键地址

合同 地址
CLMM计划 REALQqNEomY6cQGZJUGwywTBD2UmDT32rZcNnfxQ5N2
路由器 REALp6iMBDTctQqpmhBo4PumwJGcybbnDpxtax3ara3
USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
SOL So11111111111111111111111111111111111111112
bbsol Bybit2vBJGhPF52GBdNaQfUJ6ZpThSgHBobjWZpLPb4B

已知限制

  • 在中国需要代理：SDK子流程使用 HTTPS_PROXY 用于链上RPC调用。
  • 刻度对齐：CLMM位置与池对齐 tickSpacing.SDK会处理这个问题——不要预先对齐。
  • 金额为近似值：使用线性价格插值，而不是完整的CLMM报价数学。精确到~1-2%。
  • SDK需要Node.js：脚本使用 npx tsx。节点必须位于 PATH.

更新日志

v0.6.2（2026-03-03）

  • byreal_pool_analyze --多范围APR+风险评估
  • byreal_position_analyze --位置健康+池上下文
  • byreal_easy_swap --人性化 dryRun 模式
  • amountUsd 模式为 open_position + copy_position
  • 错误恢复 💡 Suggestions 在所有写操作中
  • byreal_catalog --代理自我发现
  • keypairPath 钱包支持
  • 修复：pool_info 404、pool_analyze字段映射、signAnd发送区块哈希刷新
  • 扩展CopyFarmer：排序字段、状态过滤器、农场_位置

v0.5.0

  • 36个工具、本地密钥对钱包、自动签名
  • CLMM通过SDK子流程打开/关闭/添加/删除
  • 复制带有REFERER_POSITION备忘录的农场
  • CopyFarmer排行榜

路线图

  • 重置Launchpad集成
  • 位置自动再平衡（刻度漂移检测）
  • 投资组合概要
  • 战略建议
  • 交易支出限额

相关 MCP