SODAX Builders MCP Server 是一个面向 AI 编程助手的 MCP（Model Context Protocol）服务器，旨在让开发者在其开发工作流中直接获取 SODAX 跨链 DeFi 的实时协议数据与 SDK 文档。
用途 该服务器为 AI 编程助手提供对 SODAX 跨链 API 数据的即时访问，并内置自动同步的跨链 SDK 文档，帮助开发者构建跨网络 DeFi 集成。
主要能力
- 跨网络代币兑换：支持在 20 多个网络间兑换代币。
- 货币市场利率查询：查询货币市场（money market）的借贷利率与借款 APY。
- 求解器交易量查询：查看跨网络求解器（solver）交易量。
- 意图历史检索：按交易哈希或钱包地址查询意图（intent）历史。
- 跨链中继追踪：追踪中继数据包（relay packets）及其执行状态。
- SDK 文档：提供完整的跨链 SDK 文档，文档以 docs_ 前缀的工具自动从 docs.sodax.com 代理，文档变更时自动更新，无需手动同步。
工具分类（据官方资料）
- Network Configuration（9 个工具）
- Intents & Solver（9 个工具）
- Intent Relay（3 个工具）
- AMM & Liquidity（2 个工具）
- Money Market（6 个工具）
- Partners & Token（6 个工具）
- Cross-Chain SDK Documentation（动态）
使用方式 将 MCP 服务器 URL 添加到 AI 编程助手的配置中。该服务器兼容 Claude、Cursor、VS Code、Windsurf、ChatGPT 及其他支持 MCP 的代理。一次连接即可访问所有跨网络 API 工具与 SDK 文档。对于不支持 streamable HTTP 的客户端（例如 Gemini CLI），可使用 SSE 端点（SSE Transport，旧版）。
连接后，可向 AI 编程助手提出示例问题，例如：
- 跨网络兑换与代币：“SODAX 支持哪些网络进行跨链兑换？”“获取 Base 上跨链可用的兑换代币”“如何使用 SODAX SDK 集成跨链兑换？”
- 求解器交易量与意图历史：“显示今天的跨网络求解器交易量”“查询此意图交易：0x...”“获取此钱包地址的意图历史”“报价 100 USDC 兑换 Sonic 上的 SODA”“求解器当前对 Avalanche 上 bnUSD 的预言机价格是多少？”
- 跨链中继：“追踪此源交易的 relay packets：0x...”“此交易中 conn_sn=42 的数据包是否已执行？”
- 货币市场与借贷：“SODAX 货币市场的借贷利率是多少？”“显示各资产的借款 APY”“获取我的货币市场头寸”
- SDK 文档：“如何集成 SODAX 跨链 SDK？”“展示跨网络代币兑换的代码示例”“基于意图的执行有哪些可用的 SDK 方法？”
本地开发与 CI 每个进入 development / master 的 PR 都会运行 .github/workflows/ci.yml，执行与本地相同的四项检查。Git 钩子（husky + commitlint + lint-staged）通过 pnpm install 的 prepare 脚本自动安装：pre-commit 运行 pnpm checkTs、pnpm test，然后 lint-staged（对暂存文件运行 biome check --write，应用格式化与安全 lint 修复）；commit-msg 运行 commitlint 检查 Conventional Commits 规范。紧急情况下可一次性跳过钩子，但 CI 仍会在 PR 上强制执行相同检查。
环境变量与部署 服务器启动时自动加载 .env 文件（通过 Node 的 --env-file-if-exists 标志，需要 Node ≥ 22.9.0）。本地开发可将 .env.example 复制为 .env；若不存在 .env，所有变量回退到默认值。生产环境由 Coolify 直接注入进程环境。部署通过 Coolify 采用基于分支的晋升流程：Production 跟踪 master，服务 https://builders.sodax.com；Staging 跟踪 development（仅内部）。晋升流程：功能分支 → PR 进入 development → 合并后自动部署到 staging；development → PR 进入 master → 合并后自动部署到 production。热修复可从 master 分支并直接 PR 到 master，然后合并回 development。部署说明：包含的 nixpacks.toml 自动处理部署，需设置环境变量 NODE_ENV=production。
适用场景 适用于需要在 AI 编程助手中查询 SODAX 跨链 DeFi 实时数据、检索意图与求解器信息、追踪跨链中继，或查阅跨链 SDK 文档以构建跨网络 DeFi 集成的开发者。
限制 资料未提供该服务器的收费、价格、平台限制或效果保证等信息。使用 SSE 端点仅适用于不支持 streamable HTTP 的客户端。本地运行需要 Node ≥ 22.9.0。
