Nomadex MCP

NomadexMCP

协议MCP服务器 Nomadex DEX on Voi。

建筑

NomadexMCP是位于基础设施MCP层之上的协议级MCP：

UluCoreMCP / UluVoiMCP / UluWalletMCP / UluBroadcastMCP
                                ↓
                          NomadexMCP
                                ↓
                     Nomadex analytics API (pool + token listing)
                     On-chain  (swap + liquidity txns, opt-in / resource simulation)

数据来源：

• Nomadex分析 (voimain-analytics.nomadex.app)--包含余额、数量和APR驱动器的池和令牌列表 get_pools, get_pool, get_tokens，以及池选择 get_quote / swap_txn.
• Mimir (mainnet-idx.nautilus.sh)--中的可选索引器客户端 api.js （例如ARC-200余额）；没有连接到每个MCP工具。
• 在链上 （算法）-- swap_txn 建立存款+ swapAlphaToBeta / swapBetaToAlpha 本地应用程序调用（与ABI相同 swap-api的Nomadex模块)增加/减少流动性；ARC-200复选框； populateAppCallResources 对于团体。

NomadexMCP处理：

• 使用实时余额、交易量和年利率发现池
• Nomadex池中的代币列表
• get_quote --从分析中选取的池上的局部常数乘积数学（仅限Nomadex）
• swap_txn --分析返回的任何池的未签名交换组（本机/ASA/ARC-200），与 get_quote 金额和滑点
• 添加/删除流动性（直接在链上）

NomadexMCP不会：

• 签署交易（使用UluWalletMCP）
• 广播事务（使用UluBroadcastMCP）
• 管理钱包

工具

池

代币

语录

交易准备

代理工作流

Agent calls NomadexMCP:  swap_txn(fromToken, toToken, amount, sender)
       → returns { transactions: [base64, ...], details: { route, rate, ... } }

Agent calls UluWalletMCP: wallet_sign_transactions(signerId, transactions)
       → returns signed transactions

Agent calls UluBroadcastMCP: broadcast_transactions(network, txns)
       → returns transaction IDs

项目结构

index.js              MCP server entry point (7 tools)
lib/
  api.js              Nomadex analytics, Mimir (balances)
  client.js           Algod client factory, token type inference, on-chain state
  pools.js            Pool formatting and discovery from analytics
  quotes.js           Local AMM quotes; swap txn details + amounts for swap_txn
  nomadexSwap.js      Nomadex swap ABI (deposit + swapAlphaToBeta / swapBetaToAlpha)
  builders.js         Liquidity + swap groups, opt-in prep, populateAppCallResources
data/
  contracts.json      Network config, API URLs, pool factory ID

设置

npm install

跑

node index.js

或者在代理中配置为MCP服务器：

{
  "mcpServers": {
    "nomadex": {
      "command": "node",
      "args": ["/path/to/NomadexMCP/index.js"]
    }
  }
}

令牌类型

Nomadex池支持三种代币类型：

在Voi主网上，池主要使用NATIVE（Voi）和SMART（ARC-200）令牌。

泳池工厂

Voi主网上的Nomadex池工厂是应用 411751。所有池都是通过此工厂合同创建的。

外部API

参考文献

• Nomadex网站
• 交换api --Nomadex交换txn形状的参考实现（此MCP不再调用它）
• 盟友 --DEX聚合器UI