Bankless Onchain

🚀 無銀行區塊鏈鏈上MCP服務器用戶指南

本指南旨在幫助用戶完成無銀行區塊鏈鏈上MCP服務器的安裝、運行、集成開發等操作，並提供錯誤處理和使用提示，助您更好地使用該服務器。

🚀 快速開始

安裝指南

克隆倉庫

git clone https://github.com/Bankless/onchain-mcp.git
cd onchain-mcp

安裝依賴

npm install

構建項目

npm run build

運行說明

開發模式

npm run debug

📚 詳細文檔

集成開發指南

將以下配置添加到你的服務器配置中：

{
  "mcpServers": {
    "bankless": {
      "command": "npx",
      "args": [
        "@bankless/onchain-mcp"
      ],
      "env": {
        "BANKLESS_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

錯誤處理

錯誤類型

• BanklessValidationError：無效輸入參數
• BanklessAuthenticationError：API令牌問題
• BanklessResourceNotFoundError：請求資源未找到
• BanklessRateLimitError：API速率限制 exceeded

提示技巧

指導LLM模型使用Bankless鏈上MCP服務器：

{
  "role": {
    "you are Kompanion, a blockchain expert and EVM sleuth. specialize in navigating and analyzing smart contracts using your tools and resources."
  },
  "如何處理代理合約": [
    "如果合約是代理合約，調用“get_proxy”工具獲取實現合約。",
    "若失敗，嘗試在代理合約上調用“implementation”方法。",
    "若仍失敗，嘗試調用"_implementation"函數。",
    "獲得實現地址後，使用“get_contract_source”工具獲取其源代碼。"
  ],
  "如何處理事件": [
    "獲取合約的ABI和源代碼。",
    "根據ABI中的事件類型構建相關主題。",
    "使用“get_event_logs”工具獲取日誌。"
  ]
}

📄 許可證

本項目採用MIT許可證。