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 您的目標、目標對象以及偏好的輸出格式。

建議的提示詞風格

Please introduce NAVI Protocol's current overall status in non-technical language.
I want to see the key parameters of the SUI lending pool. Please explain them to me.
If I swap 1 SUI to USDC, roughly how much would I get? Quote only, do not execute any transaction.
Help me check DEEP's contract address, decimals, and current price.
Which chains are currently supported by NAVI Astros Bridge? Can USDC on Sui be bridged?
Help me explain what happened in this Sui transaction: 2aWS5J9i4SxW3DVfKheR9Sdx6iMKPW6vfka56v5tuTSw
What Volo Vault yield vaults are available right now? Which one has the highest APY?
This is my Sui address: <YOUR_SUI_ADDRESS>. Please summarize my assets, positions, and risks.

提升提示詞品質的習慣

指定輸出風格，例如「用白話解釋」或「以研究報告格式摘要」
指定限制條件，例如「僅引用，不執行交易」或「僅限 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 客戶端是否支援遠端 MCP、Streamable HTTP 或自動協定協商，取決於客戶端自身的實作。
基於地址的查詢、跨鏈橋歷史記錄或某些聚合功能，可能會受到上游服務狀態、速率限制和逾時的影響。
如果您需要的是解釋而非原始資料，請在提示詞中明確要求 AI 進行摘要、比較或標示風險。

這對使用者體驗為何重要

NAVI Protocol MCP 的價值在於，它將多種鏈上功能統一到一個 AI 可直接呼叫的存取層中，顯著降低了使用者的認知負擔。

傳統的使用流程通常是：

在協定頁面上查看某個數字
在區塊瀏覽器中追蹤一筆交易
開啟其他頁面檢查兌換路徑或跨鏈橋支援
手動拼湊上下文並做出判斷

有了 NAVI Protocol MCP，AI 可以先擷取結構化資料，再結合您的問題，產出更貼近真實決策情境的答案。對使用者而言，真正重要的不是欄位本身，而是「我現在該如何解讀這些資料？」這正是 MCP 在產品體驗層面能發揮最大價值的地方。