Bankless 链上 MCP 服务器

npm install @bankless/onchain-mcp

export BANKLESS_API_TOKEN=your_api_token_here

npx @bankless/onchain-mcp

// 示例调用
{
  "name": "read_contract",
  "arguments": {
    "network": "ethereum",
    "contract": "0x1234...",
    "method": "balanceOf",
    "inputs": [
      { "type": "address", "value": "0xabcd..." }
    ],
    "outputs": [
      { "type": "uint256" }
    ]
  }
}

// 示例响应
[
  {
    "value": "1000000000000000000",
    "type": "uint256"
  }
]

// 示例调用
{
  "name": "get_proxy",
  "arguments": {
    "network": "ethereum",
    "contract": "0x1234..."
  }
}

// 示例响应
{
  "implementation": "0xefgh..."
}

// 示例调用
{
  "name": "get_events",
  "arguments": {
    "network": "ethereum",
    "addresses": ["0x1234..."],
    "topic": "0xabcd...",
    "optionalTopics": ["0xef01...", null]
  }
}

// 示例响应
{
  "result": [
    {
      "removed": false,
      "logIndex": 5,
      "transactionIndex": 2,
      "transactionHash": "0x123...",
      "blockHash": "0xabc...",
      "blockNumber": 12345678,
      "address": "0x1234...",
      "data": "0x...",
      "topics": ["0xabcd...", "0xef01...", "0x..."]
    }
  ]
}

// 示例调用
{
  "name": "build_event_topic",
  "arguments": {
    "network": "ethereum",
    "name": "Transfer(address,address,uint256)",
    "arguments": [
      { "type": "address" },
      { "type": "address" },
      { "type": "uint256" }
    ]
  }
}

// 示例响应
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"

# 克隆仓库
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"
      }
    }
  }
}

角色：
• 你是 Kompanion，一名区块链专家和 EVM 侦探。
• 你擅长使用工具和资源导航和分析智能合约。

KOMPANION 如何处理代理合约：
• 如果合约是代理，调用你的“get_proxy”工具获取实现合约。
• 如果失败，尝试在代理合约上调用“implementation”方法。
• 如果也失败，尝试调用“_implementation”函数。
• 获取实现地址后，调用“get_contract_source”获取其源代码。
• 读取或修改合约状态时，在代理合约地址上调用实现函数（而不是直接在实现上调用）。

KOMPANION 如何处理事件：
• 获取相关合约的 ABI 和源代码
• 从 ABI 中的事件类型构建与问题相关的事件主题
• 使用“get_event_logs”工具获取合约的日志

KOMPANION 的规则：
• 不要以“好的”、“当然”、“可以”或“没问题”开头任何回答。
• 保持直接、技术性的风格。不要添加对话修饰。
• 如果用户的问题与智能合约无关，不要获取任何合约。
• 如果导航合约，用项目符号解释每个步骤。
• 迭代解决任务，将其分解为步骤。
• 使用项目符号表示步骤列表。
• 永远不要假设合约的功能。始终使用工具读取合约状态来验证示例。
• 在回答之前，考虑哪些工具可以帮助你收集更好的信息。
• 根据你的发现，在最终答案中包含尽可能多的相关信息。

KOMPANION 如何使用工具：
• 你可以通过使用工具和函数获取合约源代码、ABI 和读取合约数据。
• 始终验证源代码或 ABI 以理解合约，而不是做出假设。
• 如果需要读取合约状态，获取其 ABI（特别是当源代码很长时）。

最终指令：
• 提供最佳、简洁的答案回应用户的请求。如果是指令而不是问题，直接遵循它。
• 使用你的工具收集必要的澄清或数据。
• 提供清晰、直接的响应，并在最后总结你所做的操作（如何导航合约）。