NAVI Protocol MCP

官方

在Sui区块链上与NAVI DeFi协议交互，获取市场数据和进行交易。

GitHub

你可以用 NAVI Protocol MCP 做什么？

获取协议概览 — 通过 navi_get_protocol_stats 查询 NAVI 的整体规模与关键指标。
检查借贷池 — 使用 navi_get_pools 和 navi_get_pool 获取特定池的供应/借款利率、LTV 及风险参数。
查看钱包健康度与奖励 — 通过 navi_get_health_factor 检查地址的健康因子，并列出未领取的借贷奖励。
汇总钱包资产与仓位 — 结合 navi_get_coins 和 get_positions 查看 Sui 地址的持仓及活跃 DeFi 仓位。
获取兑换报价 — 使用 navi_get_swap_quote 请求代币兑换的价格报价（不执行交易）。
解释 Sui 交易 — 通过 sui_explain_transaction 将原始交易 ID 转换为通俗易懂的操作与结果说明。

文档

NAVI Protocol MCP 用户指南

一个面向 AI 客户端的公共 DeFi 数据与解释接口。无需 API 密钥，开箱即用，适用于用户查询、内容研究和技术集成。

一句话概括

NAVI Protocol MCP 是一个开放的模型上下文协议服务。它将 NAVI Protocol 生态中分散的能力——包括借贷、兑换、跨链桥、DCA、Volo Vault 收益金库、钱包资产以及 Sui 交易解读——打包成一套标准化的工具集，供 AI 客户端直接调用。

其核心价值不仅仅是“又一个 API”。它将通常需要在协议页面、区块浏览器和多个产品页面之间来回跳转才能获取的信息，转化为 AI 能够理解、组合并解释的结构化上下文。用户只需用自然语言提问，AI 即可调用 NAVI Protocol MCP，给出更贴近实际决策需求的答案。

适用人群

希望快速了解 NAVI Protocol 生态，而不想手动查阅多个页面的普通用户
已在 Sui 上活跃的链上用户，希望借助 AI 解读资产、仓位、交易和风险
希望使用一个公开、免费、无需认证的 DeFi MCP 服务的开发者、研究人员或团队
希望由 AI 负责数据检索和结果解读，以便专注于分析和决策的内容创作者和分析师

核心访问信息

项目	详情
端点	`https://open-api.naviprotocol.io/api/mcp`
认证	无需 API 密钥
费用	免费
推荐传输方式	Streamable HTTP
能力边界	只读查询与解释；不处理签名、授权或交易执行

3 分钟快速上手

方案 A：在支持远程 MCP 的客户端中直接添加

如果你的客户端提供了 Add MCP Server、Remote MCP 或 HTTP MCP 等入口，你只需要以下信息：

服务器名称：navi-protocol
URL：https://open-api.naviprotocol.io/api/mcp
Headers：留空

保存并重新连接。之后即可在对话中直接提问，无需记忆具体的工具名称。

方案 B：Cursor 示例

如果你使用 Cursor，可在 MCP 配置中添加一个远程服务器：

{
  "mcpServers": {
    "navi-protocol": {
      "url": "https://open-api.naviprotocol.io/api/mcp"
    }
  }
}

配置完成后，刷新 MCP 列表或重启客户端，然后在聊天框中直接提问。

方案 C：Claude Code 示例

如果你使用 Claude Code，可通过命令行添加 HTTP MCP 服务：

claude mcp add --transport http navi-protocol https://open-api.naviprotocol.io/api/mcp

方案 D：Codex 示例

如果你使用 OpenAI Codex，可在全局或项目级的 config.toml（例如 ~/.codex/config.toml 或 .codex/config.toml）中添加 MCP 服务器：

[mcp_servers.navi-protocol]
url = "https://open-api.naviprotocol.io/api/mcp"

你也可以通过 CLI 快速添加：

codex mcp add navi-protocol --url https://open-api.naviprotocol.io/api/mcp

设置完成后，使用以下两个提示词快速验证连通性：

Please explain in plain language what capabilities NAVI Protocol mainly supports right now.
Please list NAVI's major lending pools.

如何提出更好的问题

普通用户无需手动调用工具。最佳方式是直接告诉 AI 你的目标、目标对象以及偏好的输出格式。

获得更高质量提示词的习惯

指定输出风格，例如“用通俗语言解释”或“以研究报告格式总结”
指定约束条件，例如“仅引用，不执行交易”或“仅限 Sui 主网”
指定优先级，例如“优先关注风险”、“优先关注可领取奖励”或“优先关注跨链桥可达性”

当前可用的公共能力

下表总结了 NAVI Protocol MCP 目前开放的主要能力，以及用户可直接提问的自然语言提示词示例。

用例	代表性工具	推荐提示词
协议概览	`navi_get_protocol_stats`	`What is the current overall scale of NAVI Protocol?`
借贷池分析	`navi_get_pools`、`navi_get_pool`	`What are the supply/borrow rates, LTV, and risk parameters for the SUI pool?`
风险检查	`navi_get_health_factor`、`navi_get_price_feeds`	`Is this address's health factor safe?`
奖励信息	`navi_get_lending_rewards`、`navi_get_available_rewards`	`What lending rewards are still unclaimed for this address?`
钱包与仓位	`navi_get_coins`、`get_positions`	`Please summarize this address's current assets and DeFi positions.`
市场配置	`navi_get_market_config`	`Which assets are currently supported in NAVI Main Market?`
代币信息	`navi_search_tokens`	`Help me check DEEP's contract address, decimals, and current price.`
兑换报价	`navi_get_swap_quote`	`If I swap 1 SUI to USDC, about how much can I get?`
跨链桥发现	`navi_get_bridge_chains`、`navi_search_bridge_tokens`、`navi_get_bridge_quote`	`Which chains support bridging? Can this token bridge cross-chain?`
跨链桥追踪	`navi_get_bridge_tx_status`、`navi_get_bridge_history`	`Help me check what stage this bridge transaction is currently in.`
DCA 查询	`navi_get_dca_orders`、`navi_get_dca_order_details`、`navi_list_dca_orders`	`Please list DCA orders for this address.`
Volo Vault 概览	`volo_get_vaults`、`volo_get_vault`、`volo_get_vault_system_summary`	`What Volo Vault yield vaults are available? What is the overall TVL and revenue?`
Volo Vault 分析	`volo_get_vault_apy_history`、`volo_get_vault_share_price_history`、`volo_get_vault_tvl_history`、`volo_get_vault_total_tvl_history`	`How has this Volo Vault's APY trended over the past month?`
Volo Vault 用户仓位	`volo_get_vault_user_positions`、`volo_get_vault_user_status`、`volo_get_vault_user_transactions`	`How much has this address staked in Volo Vault? What are the earnings?`
交易解读	`sui_get_transaction`、`sui_explain_transaction`	`Please translate this transaction into plain human-readable language.`

基于地址提问的推荐模板

如果你愿意提供自己的 Sui 地址，AI 可以进一步汇总你的资产、仓位、风险和奖励。以下是一个可直接复制使用的模板：

This is my Sui address: <YOUR_SUI_ADDRESS>.
Please help me with the following 5 things:
1. Summarize what assets I currently hold;
2. Summarize my positions in NAVI and other protocols;
3. If my health factor has risk, warn me directly;
4. Tell me whether I have any unclaimed rewards;
5. Summarize my Volo Vault positions and earnings.

这类请求通常会组合以下能力：

navi_get_coins
get_positions
navi_get_health_factor
navi_get_available_rewards
volo_get_vault_user_positions
volo_get_vault_user_status

如果基于地址的查询偶尔遇到上游速率限制或超时，稍后重试通常即可解决。

面向技术用户的直接测试

如果你想先在终端中验证服务可用性，可以直接发送 MCP 请求。以下初始化示例使用协议版本 2025-06-18，该版本已在本指南中验证。如果你的客户端会自动协商协议版本，则无需手动指定。

1. 初始化

curl https://open-api.naviprotocol.io/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data-binary '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": {
        "name": "demo-client",
        "version": "1.0.0"
      }
    }
  }'

2. 列出工具

curl https://open-api.naviprotocol.io/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data-binary '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list",
    "params": {}
  }'

3. 直接调用工具

curl https://open-api.naviprotocol.io/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data-binary '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "navi_get_protocol_stats",
      "arguments": {}
    }
  }'

使用技巧

如果你是第一次接触 DeFi，请让 AI 用通俗语言解释结果，而不是直接输出原始 JSON。
如果你想评估某个资产或池子是否值得深入研究，可先按此路径操作：协议概览 -> 池参数 -> 报价 -> 风险。
如果你不确定某个代币的合约地址或小数位数，可直接按符号搜索，例如：Help me check DEEP token info。
如果你打算提供自己的地址，请让 AI 一并汇总资产、仓位和风险，这样结果更全面、效率更高。
如果你只想先测试连通性，可以从不依赖钱包地址的提示词开始，例如协议概览、SUI 池参数或某笔公开交易的解读。

常见边界与注意事项

NAVI Protocol MCP 目前作为只读查询与解释层提供服务。它不处理签名、授权或直接交易执行。
AI 客户端是否支持 Remote MCP、Streamable HTTP 或自动协议协商，取决于客户端自身的实现。
基于地址的查询、跨链桥历史记录或某些聚合能力，可能会受到上游服务状态、速率限制和超时的影响。
如果你需要的是解读而非原始数据，请在提示词中明确要求 AI 进行总结、对比或突出风险。

这对用户体验为何重要

NAVI Protocol MCP 的价值在于，它将多种链上能力统一到一个 AI 可直接调用的访问层中，显著降低了用户的认知负担。

传统使用流程通常是：

在协议页面查看某个数字
在区块浏览器中追踪一笔交易
打开其他页面检查兑换路径或跨链桥支持
手动拼凑上下文并做出判断

借助 NAVI Protocol MCP，AI 可以先获取结构化数据，再结合你的问题，给出更贴近真实决策场景的答案。对用户而言，真正重要的不是字段本身，而是“此刻我该如何解读这些数据？”这正是 MCP 在产品体验层面发挥最大价值的地方。