SODAX Builders MCP

SODAX Builders MCP 服务

从你偏好的 MCP 目录安装

   

面向 AI 编码助手的 SODAX MCP 服务。访问实时跨网络（跨链）API 数据：在 20 多个网络间兑换代币、查询货币市场利率、查看求解器交易量并搜索意图历史记录。包含完整的跨链 SDK 文档，并自动与 SODAX 开发者文档同步。通过开发工作流直接使用实时协议数据，构建跨网络 DeFi 集成。

一句话介绍： SODAX MCP 服务：提供实时跨网络 DeFi API 数据，以及适用于 20 多个网络并自动更新的 SDK 文档。可通过 AI 编码助手查询兑换、借贷、求解器交易量和意图历史记录。

快速开始

将 MCP 服务 URL 添加到 AI 编码助手的配置中：

{
  "mcpServers": {
    "sodax-builders": {
      "url": "https://builders.sodax.com/mcp"
    }
  }
}

兼容 Claude、Cursor、VS Code、Windsurf、ChatGPT 和其他兼容 MCP 的 Agent。只需建立一个连接，即可访问所有跨网络 API 工具和 SDK 文档。

SSE 传输（旧版）

对于不支持可流式 HTTP 的客户端（例如 Gemini CLI），请改用 SSE 端点：

{
  "mcpServers": {
    "sodax-builders": {
      "url": "https://builders.sodax.com/sse"
    }
  }
}

工具

网络配置（9 个工具）

工具	描述
sodax_get_supported_chains	列出 SODAX 支持跨链兑换的所有区块链网络
sodax_check_chain_support	按名称、代号或键检查 SODAX 是否支持某条链（例如 “Hedera”、“HBAR”）
sodax_get_swap_tokens	获取可用于跨网络兑换的代币，可按链筛选
sodax_get_all_config	一次调用获取完整的 SODAX 配置（链 + 代币）
sodax_get_all_chains_configs	获取包含合约地址和 RPC 的详细 spoke 链配置
sodax_get_relay_chain_id_map	获取链 ID 到意图中继链 ID 的映射
sodax_get_hub_assets	获取代表 spoke 代币的 hub（Sonic）资产
sodax_get_money_market_tokens	获取各链支持的货币市场代币
sodax_get_money_market_reserve_assets	获取货币市场储备资产

意图与求解器（9 个工具）

工具	描述
sodax_get_transaction	按哈希查找意图交易——包括状态、金额和详情
sodax_get_intent	按意图哈希查找特定意图
sodax_get_user_transactions	获取指定钱包地址的意图/交易历史记录
sodax_get_volume	获取求解器交易量数据（已完成的意图），支持筛选和分页
sodax_get_volume_stats	获取汇总的求解器交易量统计数据
sodax_get_orderbook	获取求解器当前的跨链订单簿条目
sodax_get_solver_intent	获取求解器侧的意图详情和成交历史
sodax_get_solver_oracle	获取求解器对每个受支持的（链，代币）组合的预言机价格
sodax_get_solver_quote	从求解器获取兑换报价（exact_input 或 exact_output）

意图中继（3 个工具）

工具	描述
sodax_relay_submit_tx	将已确认的 spoke 链交易提交到意图中继，以便跨链交付
sodax_relay_get_transaction_packets	列出源交易发出的所有跨链数据包
sodax_relay_get_packet	按连接序列号获取单个中继数据包

AMM 与流动性（2 个工具）

工具	描述
sodax_get_amm_positions	按所有者获取 AMM 流动性提供者 NFT 仓位
sodax_get_amm_pool_candles	获取 AMM 池的 OHLCV K 线图数据

货币市场（6 个工具）

工具	描述
sodax_get_money_market_assets	列出所有借贷资产及利率
sodax_get_money_market_asset	按储备金地址获取特定资产的详细信息
sodax_get_user_position	获取用户的货币市场仓位（供应、借款、健康度）
sodax_get_asset_borrowers	获取特定货币市场资产的借款人
sodax_get_asset_suppliers	获取特定货币市场资产的供应方（贷款人）
sodax_get_all_borrowers	获取所有货币市场资产的全部借款人

合作伙伴与代币（6 个工具）

工具	描述
sodax_get_partners	列出各网络上的 SODAX 集成合作伙伴
sodax_get_partner_summary	获取特定合作伙伴的交易量和活动摘要
sodax_get_token_supply	获取 SODA 代币供应量信息（总量、流通量、销毁量）
sodax_get_total_supply	以纯数字形式获取 SODA 总供应量
sodax_get_circulating_supply	以纯数字形式获取 SODA 流通供应量
sodax_refresh_cache	清除缓存数据以获取最新结果

跨链 SDK 文档（动态）

以 docs_ 为前缀的工具会自动通过代理调用 SODAX 文档 MCP（地址：docs.sodax.com）。文档变更时，这些工具会自动更新，无需手动同步。

工具	描述
docs_search_sodax_docs	搜索跨链 SDK 文档、集成指南和代码示例
docs_query_docs_filesystem_sodax_docs	从文档文件系统读取完整文档页面
docs_list_tools	列出所有可用的文档工具
docs_health	检查 SDK 文档 MCP 的连接状态
docs_refresh	从文档 MCP 刷新工具列表

示例提示词

连接后，可以尝试向 AI 编码助手提问：

跨网络兑换与代币

• “SODAX 支持哪些网络进行跨链兑换？”
• “获取 Base 上各链可用的兑换代币”
• “如何使用 SODAX SDK 集成跨链兑换？”

求解器交易量与意图历史记录

• “显示今天的跨网络求解器交易量”
• “查询这笔意图交易：0x...”
• “获取此钱包地址的意图历史记录”
• “帮我报价：在 Sonic 上将 100 USDC 兑换为 SODA”
• “求解器当前采用的 Avalanche 上 bnUSD 预言机价格是多少？”

跨链中继

• “跟踪此源交易的中继数据包：0x...”
• “此交易中 conn_sn=42 的数据包是否已执行？”

货币市场与借贷

• “SODAX 货币市场的借贷利率是多少？”
• “显示各资产的借款 APY 利率”
• “获取我的货币市场仓位”

SDK 文档

• “如何集成 SODAX 跨链 SDK？”
• “显示跨网络代币兑换的代码示例”
• “基于意图的执行有哪些可用 SDK 方法？”

数据来源

来源	类型	缓存
SODAX Backend API（api.sodax.com/v1/be）	实时跨网络数据	2 min
SODAX Solver API（api.sodax.com/v1/intent）	预言机价格 + 兑换报价	2 min（预言机）；无（报价）
SODAX Intent Relay（xcall-relay.nw.iconblockchain.xyz）	跨链数据包跟踪	无
聚合器	跨链兑换代币数据	2 min
SODAX Docs MCP（docs.sodax.com）	SDK 文档	自动同步

本地开发

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Start production server
pnpm start

# Run the test suite (unit tests for drift-check logic)
pnpm test

CI 与本地检查

每个合并到 development/master 的 PR 都会运行 .github/workflows/ci.yml，执行以下四项检查；你也可以在本地运行：

命令	作用
pnpm checkTs	使用 tsc --noEmit 对项目进行类型检查（不生成构建输出）。
pnpm lint	使用 Biome（biome check .）检查仓库。添加 :fix 可自动应用安全修复。
pnpm build	编译 TypeScript，并将 src/public 复制到 dist/。
pnpm test	运行 Vitest 测试套件（目前覆盖 src/services/apiDriftCheck.ts 中的漂移检查逻辑）。

Git 钩子（husky + commitlint + lint-staged）

pnpm install 会通过 prepare 脚本自动安装钩子：

• pre-commit — 运行 pnpm checkTs、pnpm test，然后运行 lint-staged（对暂存文件运行 biome check --write，应用格式调整和安全的 lint 修复）。
• commit-msg — 根据 Conventional Commits 规范运行 commitlint。feat: add X 之类的消息可以通过；bad message 会被拒绝。

如遇紧急情况，需要临时跳过钩子：

HUSKY=0 git commit -m "your message"

不要养成跳过钩子的习惯——CI 仍会在 PR 上执行相同的检查。

环境变量

服务启动时会自动加载 .env 文件（通过 Node 的 --env-file-if-exists 标志——需要 Node ≥ 22.9.0）。本地开发时，将 .env.example 复制为 .env； 如果不存在 .env，所有变量都会使用下表中的默认值。在生产环境中， Coolify 会将这些变量直接注入进程环境。

变量	默认值	描述
PORT	3000	服务端口
TRANSPORT	http	传输模式（http 或 stdio）
NODE_ENV	-	部署时设为 production
LOG_LEVEL	info	日志详细程度。可选值：trace、debug、info、warn、error、fatal。
DISCORD_WEBHOOK_URL	-	用于运行时告警的 Discord webhook：服务状态（启动/停止）、重大错误（未捕获/未处理）和 API 漂移摘要。为空或未设置 = 静默（预发布/本地）。

部署

环境

服务通过 Coolify 部署，并采用基于分支的晋级流程：

• 生产环境 — 跟踪 master，提供 https://builders.sodax.com
• 预发布环境 — 跟踪 development（仅内部使用）

晋级流程：

1. 功能分支 → 向 development 提交 PR → 合并后自动部署到预发布环境。
2. development → 向 master 提交 PR → 合并后自动部署到生产环境。

可以从 master 创建分支来修复紧急问题，并直接向 master 提交 PR，之后再合并回 development。

Docker

docker build -t builders-sodax-mcp-server .
docker run -p 3000:3000 builders-sodax-mcp-server

Docker Compose

docker-compose up -d

部署说明

附带的 nixpacks.toml 会自动处理部署。设置以下环境变量：

• PORT=3000
• NODE_ENV=production

API 端点

端点	描述
GET /	落地页
GET /api	服务信息和工具列表
GET /health	健康检查
POST /mcp	MCP 端点（可流式传输的 HTTP）
GET /sse	SSE 端点（旧版传输方式）
POST /messages	SSE 消息端点

相关链接

• SODAX — sodax.com
• SDK 文档 — docs.sodax.com（自动代理）

许可证

MIT