Okto MCP Server

🚀 Okto Web3 MCP 服務器

Okto Web3 MCP 服務器是一個用於 Okto Web3 整合的模型上下文協議（MCP）服務器，專為 Claude 桌面應用打造，還具備自動身份驗證功能。藉助該服務器，AI 助手能夠通過自然語言交互，輕鬆管理 Web3 交易和資產組合。

🚀 快速開始

Okto Web3 MCP 服務器能讓 AI 助手藉助自然語言交互管理 Web3 交易和資產組合。你可以按以下步驟完成安裝與配置：

1. 準備好 OAuth 憑證並完成環境變量配置。
2. 運行認證腳本獲取訪問令牌。
3. 在 Claude 桌面應用中添加相應配置。

✨ 主要特性

• 查看資產組合詳情，涵蓋持倉和餘額等信息。
• 獲取多條鏈上的賬戶信息。
• 列出與賬戶關聯的所有 NFT 收藏品。
• 檢視交易歷史記錄。
• 查看詳細的 NFT 持倉信息。
• 列出所有可用代幣及其細節。
• 轉移代幣至指定地址。
• 獲取所有支持的區塊鏈網絡列表。

📦 安裝指南

1. OAuth 憑證準備

• 確保擁有有效的 Google OAuth 2.0 憑證文件 gcp-oauth.keys.json。
• 將其置於當前目錄或用戶主目錄下的 .okto-mcp 文件夾中。

2. 環境變量配置

export OKTO_ENV=development  # 或 production

3. 身份驗證流程

• 運行認證腳本以獲取訪問令牌。
• 腳本將自動處理憑證文件並建立安全的授權會話。

📚 詳細文檔

Claude 桌面應用配置

在 ~/.config/claude/web3.json 中添加以下配置：

{
  "mcp-server": {
    "url": "http://localhost:3000",
    "auth": {
      "type": "okto",
      "env": "${OKTO_ENV}"
    }
  }
}

可用工具

1. 資產組合詳情查詢

{
  "examples": ["查詢所有鏈上的資產情況"]
}

2. 多鏈賬戶信息獲取

{}

3. NFT 收藏品列表

{}

4. 交易歷史記錄

{}

5. NFT 資產組合詳情

{}

6. 可用代幣列表

{}

7. 代幣轉移操作

指定轉賬參數：

{
  "amount": "1000000000000000000",
  "recipient": "0x...",
  "token": "0x...",
  "caip2Id": "eip155:1"
}

8. 支持鏈路列表

{}

安全須知

• OAuth 憑證安全存儲於本地環境 (~/.okto-mcp)。
• 服務器採用離線訪問模式以維持持久認證狀態。
• 切勿共享或提交憑證到版本控制系統中。
• 定期檢查並吊銷未使用的 Google 賬戶權限。
• Okto 憑證應通過環境變量安全存儲。
• 憑證對當前用戶僅限訪問。

故障排除

1. OAuth 密鑰未找到

• 確保 gcp-oauth.keys.json 文件存在於當前目錄或 ~/.okto-mcp/。
• 核查文件權限設置。

2. 憑證格式無效

• 確認 OAuth 憑證文件包含有效 web 或 installed 類型配置。
• 對於 web 應用，核實重定向 URI 配置正確。

3. 端口已被佔用

• 若端口 3000 被佔用，請釋放該端口後再運行認證流程。
• 可使用命令查找並終止佔用進程。

4. Okto 認證失敗

• 檢查環境變量配置是否正確。
• 確認 Okto 憑證有效無誤。
• 確保使用正確的環境（測試/生產）。

📄 許可證

ISC

支持與反饋

如遇問題或有任何疑問，請在 GitHub 倉庫中提交 ISSUE。