NAVI Protocol MCP

ทางการ

โต้ตอบกับโปรโตคอล NAVI DeFi บนบล็อกเชน Sui สำหรับข้อมูลตลาดและธุรกรรม

GitHub

คุณทำอะไรได้บ้างด้วย NAVI Protocol MCP?

Get a protocol-wide summary — Ask for NAVI’s overall scale and key metrics using navi_get_protocol_stats.
Inspect lending pools — Retrieve supply/borrow rates, LTV, and risk parameters for specific pools via navi_get_pools and navi_get_pool.
Check wallet health and rewards — Review an address’s health factor with navi_get_health_factor and list unclaimed lending rewards.
Summarize wallet assets and positions — Combine navi_get_coins and get_positions to see holdings and active DeFi positions for a Sui address.
Get a swap quote — Request a price quote for a token swap without executing a trade using navi_get_swap_quote.
Explain a Sui transaction — Turn a raw transaction ID into plain-language actions and effects with sui_explain_transaction.

เอกสาร

คู่มือผู้ใช้ NAVI Protocol MCP

อินเทอร์เฟซข้อมูล DeFi สาธารณะและคำอธิบายสำหรับไคลเอนต์ AI ไม่ต้องใช้ API key พร้อมใช้งานทันที และเหมาะสำหรับคำถามผู้ใช้ การวิจัยเนื้อหา และการผสานรวมทางเทคนิค

ในหนึ่งประโยค

NAVI Protocol MCP คือบริการ Model Context Protocol แบบเปิด ซึ่งรวบรวมความสามารถที่กระจัดกระจายทั่วระบบนิเวศของ NAVI Protocol ซึ่งรวมถึงการให้กู้ยืม การแลกเปลี่ยน การเชื่อมข้ามเชน DCA Volo Vault yield vaults สินทรัพย์ในกระเป๋า และการตีความธุรกรรมของ Sui ให้เป็นชุดเครื่องมือมาตรฐานที่ไคลเอนต์ AI สามารถเรียกใช้ได้โดยตรง

คุณค่าหลักของมันไม่ใช่แค่ "API อีกตัวหนึ่ง" แต่มันเปลี่ยนข้อมูลที่ปกติต้องกระโดดไปมาระหว่างหน้าโปรโตคอล บล็อกเอ็กซ์พลอเรอร์ และหน้าผลิตภัณฑ์หลายหน้า ให้กลายเป็นบริบทที่มีโครงสร้างที่ AI สามารถเข้าใจ ผสมผสาน และอธิบายได้ ผู้ใช้สามารถถามคำถามด้วยภาษาธรรมชาติ และ AI สามารถเรียกใช้ NAVI Protocol MCP เพื่อสร้างคำตอบที่ใกล้เคียงกับความต้องการในการตัดสินใจจริง

เหมาะสำหรับใคร

ผู้ใช้ทั่วไปที่ต้องการทำความเข้าใจระบบนิเวศของ NAVI Protocol อย่างรวดเร็ว โดยไม่ต้องตรวจสอบหลายหน้าด้วยตนเอง
ผู้ใช้บนเชนที่ใช้งาน Sui อยู่แล้ว และต้องการให้ AI ช่วยตีความสินทรัพย์ สถานะ ธุรกรรม และความเสี่ยง
นักพัฒนา นักวิจัย หรือทีมที่ต้องการบริการ DeFi MCP สาธารณะ ฟรี ไม่ต้องยืนยันตัวตน
ผู้สร้างเนื้อหาและนักวิเคราะห์ที่ต้องการให้ AI จัดการการดึงข้อมูลและตีความผลลัพธ์ เพื่อให้พวกเขามุ่งเน้นไปที่การวิเคราะห์และการตัดสินใจ

ข้อมูลการเข้าถึงหลัก

รายการ	รายละเอียด
ปลายทาง	`https://open-api.naviprotocol.io/api/mcp`
การยืนยันตัวตน	ไม่ต้องใช้ API key
ค่าใช้จ่าย	ฟรี
การขนส่งที่แนะนำ	Streamable HTTP
ขอบเขตความสามารถ	การสอบถามและตีความแบบอ่านอย่างเดียว ไม่จัดการการลงนาม การอนุญาต หรือการดำเนินการธุรกรรม

เริ่มต้นใน 3 นาที

ตัวเลือก A: เพิ่มโดยตรงในไคลเอนต์ที่รองรับ Remote 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 ให้เพิ่มเซิร์ฟเวอร์ MCP ใน config.toml ระดับโกลบอลหรือระดับโปรเจกต์ (ตัวอย่างเช่น ~/.codex/config.toml หรือ .codex/config.toml):

[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 mainnet"
ระบุลำดับความสำคัญ เช่น "เน้นความเสี่ยงก่อน" "เน้นรางวัลที่ขอรับได้ก่อน" หรือ "เน้นความสามารถในการเข้าถึงของบริดจ์ก่อน"

ความสามารถสาธารณะที่มีให้ใช้งานในปัจจุบัน

ตารางด้านล่างสรุปความสามารถหลักที่ 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 มอบคุณค่าสูงสุดในระดับประสบการณ์ผลิตภัณฑ์