使用说明
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）
- 管理钱包
工具
池
| 工具 | 说明 |
|---|---|
get_pools |
列出Nomadex池及其余额、TVL、交易量和APR |
get_pool |
按应用程序ID获取特定池的详细信息 |
代币
| 工具 | 说明 |
|---|---|
get_tokens |
列出Nomadex上可用的代币，包括合约ID和池计数 |
语录
| 工具 | 说明 |
|---|---|
get_quote |
通过本地Nomadex AMM数学在分析池上交换报价（无交换api） |
交易准备
| 工具 | 说明 |
|---|---|
swap_txn |
在链上构建未签名的掉期交易（存款+池掉期；任何分析池） |
add_liquidity_txn |
构建未签名交易，为Nomadex池增加流动性 |
remove_liquidity_txn |
构建未签名交易以从Nomadex池中删除流动性 |
代理工作流
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池支持三种代币类型：
| 类型 | 值 | 描述 |
|---|---|---|
| NATIVE | 0 | 本机VOI令牌 |
| ASA | 1 | Algorand标准资产 |
| SMART | 2 | ARC-200智能资产 |
在Voi主网上，池主要使用NATIVE（Voi）和SMART（ARC-200）令牌。
泳池工厂
Voi主网上的Nomadex池工厂是应用 411751。所有池都是通过此工厂合同创建的。
外部API
| API | 基本URL | 使用者 |
|---|---|---|
| Nomadex分析 | https://voimain-analytics.nomadex.app |
get_pools, get_pool, get_tokens，游泳池选择 get_quote / swap_txn |
| Mimir索引器 | https://mainnet-idx.nautilus.sh/nft-indexer/v1/ |
fetchTokenBalances 在 api.js |
开始（或） https://mainnet-api.voi.nodely.dev |
掉期+流动性交易、模拟/资源人口 |
