indigo-mcp 是 Indigo Protocol 的 MCP（Model Context Protocol）服务器，其作用是让大语言模型（LLM）智能体通过 MCP 协议访问 Cardano 区块链上 Indigo Protocol 的相关数据与操作。
一、用途与定位 该服务器将 Indigo 的 iAsset 数据、价格以及 CDP/借贷分析能力暴露给 LLM 智能体。官方资料将其描述为进一步的 Cardano DeFi 技术栈的一部分，可与 Cardano MCP 组合使用以获得完整能力。
二、主要能力 根据官方资料，该 MCP 服务器提供（共 75 个工具，另有 13 个可选 AI Skills）以下能力：
- 实时 iAsset 价格（iUSD、iBTC、iETH、iSOL、iEUR、iJPY）
- ADA 与 INDY 代币价格源
- CDP/借贷浏览，支持分页与筛选
- 按支付密钥哈希或 bech32 地址查询所有者
- CDP 健康度分析，含抵押率与清算风险状态
- 稳定池状态与账户查询
- INDY 质押仓位与管理器状态
- 协议分析：TVL、APR 奖励、DEX 收益率、聚合统计
- 治理：协议参数、投票、温度检查
- 赎回订单簿与队列聚合
- DEX 代理：Steelswap 兑换、Iris 流动性池、Blockfrost 余额
- CDP 清算、赎回、冻结与合并操作
- 通过 ROB 头寸开设杠杆 CDP
- ROB（赎回订单簿）头寸管理
- 预言机利率喂价与初始化
- 稳定池请求处理与取消
- 质押奖励分发
- Collector UTXO、IPFS 存储与检索 资料中的工具类别包括：CDP/贷款工具、CDP 写入工具、CDP 铸造/销毁工具、CDP 清算与赎回工具、杠杆 CDP 工具、稳定池工具、稳定池请求工具、质押写入工具、质押奖励工具、分析与 APR 工具、治理工具、赎回与订单簿工具、ROB 写入工具、DEX 代理工具、Collector 与 IPFS 工具、利率工具（v3）、预言机/Pyth 工具（v3）、Stableswap 工具（v3）。
三、使用方式
- 自动安装（推荐）：运行交互式安装脚本，自动配置 MCP 客户端（Claude Desktop、Claude Code、Cursor、Windsurf），并询问 Blockfrost API 密钥、自动更新配置文件，无需手动编辑。
- 手动安装：可全局安装，或直接使用 npx 运行（无需安装）。
- HTTP 传输（远程/托管部署）：服务器支持 HTTP 传输，提供 POST /mcp（带 SSE 的 Streamable HTTP）与 GET /health 健康检查；每个客户端拥有独立会话，initialize 返回 Mcp-Session-Id，后续请求需携带，客户端重启可重新 initialize 而不影响既有会话。绑定地址与端口来自 HOST 与 PORT。
- 宿主部署：官方资料提到在 Fronteir AI 上有托管部署。
- 环境变量：BLOCKFROST_API_KEY 为写入操作（交易构建）所必需，只读工具无需该密钥；可在 blockfrost.io 获取免费密钥。
- 读操作示例查询（自然语言）：如“当前所有 Indigo iAsset 的价格是多少？”“iUSD 现在的价格是多少？”“ADA 兑美元价值多少？”“显示所有 iETH CDP”“这个地址拥有哪些 CDP？”“分析我的 CDP 健康度”“我的仓位是否有清算风险？”“显示当前稳定池状态”“我在稳定池的存款是多少？”“我质押了多少 INDY？”“Indigo 当前 TVL 是多少？”“iUSD 稳定池可获得多少 APR？”“当前治理协议参数是什么？”“显示 iUSD 赎回队列”“估算用 100 ADA 兑换 iUSD 的 Steelswap 报价”“iAsset 交易对当前 DEX 收益率是多少？”等。
四、价格依赖写入的时间限制 资料指出，由 Pyth 定价的 iAsset 存在提交截止时间：每个 iAsset 当前均通过 Pyth 定价，链上喂价验证器仅接受在价格更新后 280 秒内嵌入该更新的交易。依赖价格的写入工具（open_cdp、withdraw_cdp、mint_cdp、redeem_cdp、freeze_cdp、leverage_cdp、redeem_rob）会返回含价格、时间戳与 submitBefore 截止时间的 summary.pyth 区块。若签名耗时超过该期限（如硬件钱包或人工在浏览器中确认），应重建交易而非提交过期交易；已过期的价格更新会在构建时被拒绝并给出重试提示。
五、x402 支付门控（可选） 该 MCP 可选地使用 x402 协议对工具调用按次进行微支付门控，默认禁用，需至少设置一个钱包地址方可启用。计费标准为：读工具（如 get_tvl、get_asset_price）每次 0.001 USDC；分析工具（如 analyze_cdp_health）每次 0.005 USDC；写入工具（如 open_cdp、mint_cdp）每次 0.01 USDC。采用拆分执行模型：工具调用无需调用方提供支付头，门控拦截并联系结算 worker（默认为 mcp.openmm.io），worker 返回 402 及 EIP-3009 要求（金额、收款方、链），门控使用 X402_PRIVATE_KEY 在本地签名（密钥不离开本进程），重试并携带签名支付，worker 链上验证后签发 JWT，门控本地验证 JWT 后执行原工具处理，并将结算交易哈希注入工具响应。该设计使 indigo-mcp 从不持有收款钱包，仅持有付款密钥。相关环境变量包括 PAYMENT_SERVER 与 X402_PRIVATE_KEY；未设置 X402_PRIVATE_KEY 时门控禁用，所有工具无需支付即可执行。Base 主网需将 X402_TESTNET 设为 false 或省略。
六、运行环境与技术说明 需要 Node.js >= 20（内置 undici 需要 Node 20 引入的 File 全局对象）。服务器通过 stdio 使用 JSON-RPC 通信，可通过 stdin 直接测试工具。发布渠道包括 npm、MCP Registry、容器镜像（Dockerfile 从源码构建，供 Fly 等容器主机使用）以及 Smithery。发布流程：合并版本号变更（SERVER_VERSION 读自 package.json）、打 tag 并推送、CI 先发布到 npm 再发布到 MCP Registry（registry 通过包的 mcpName 字段验证所有权，因此 npm 必须先发布）、使用 fly deploy 部署托管 HTTP 端点、pnpm smithery:publish 发布到 Smithery。
七、限制与注意事项 价格依赖写入存在 280 秒提交截止限制，过期交易会被拒绝。写入操作需要 BLOCKFROST_API_KEY。x402 支付默认禁用，启用后按上述标准计费。资料未提供具体收费模式、平台支持范围之外的细节或效果保证。
