Bankless Onchain MCP Server

Bankless Onchain MCP Server

site icon
2025.04.11 27
TypeScript区块链服务智能合约交互金融服务
Bankless Onchain MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,用于通过 Bankless API 与区块链数据进行交互。它提供了一个框架,允许 AI 模型以结构化的方式访问区块链状态和事件数据。
View on GitHub

Overview

基本能力

产品定位

Bankless Onchain MCP Server 是一个用于区块链数据交互的工具,特别适用于需要访问智能合约状态、事件日志和交易历史的场景。

核心功能

  1. 合约操作
  2. 读取合约状态 (read_contract)
  3. 获取代理合约地址 (get_proxy)
  4. 获取合约 ABI (get_abi)
  5. 获取合约源代码 (get_source)

  6. 事件操作

  7. 获取事件日志 (get_events)
  8. 构建事件主题 (build_event_topic)

  9. 交易操作

  10. 获取交易历史 (get_transaction_history)
  11. 获取交易详情 (get_transaction_info)

适用场景

  • 区块链数据分析
  • 智能合约审计
  • 交易历史查询
  • 事件日志分析

工具列表

  1. read_contract
  2. 从区块链读取合约状态
  3. 输入参数包括网络、合约地址、方法和输入输出类型

  4. get_proxy

  5. 获取代理合约的实现地址
  6. 输入参数包括网络和合约地址

  7. get_events

  8. 获取符合条件的事件日志
  9. 输入参数包括网络、地址列表和主题

  10. build_event_topic

  11. 根据事件名称和参数类型构建事件主题
  12. 输入参数包括网络、事件名称和参数类型

常见问题解答

  • BanklessValidationError: 输入参数无效
  • BanklessAuthenticationError: API 令牌问题
  • BanklessResourceNotFoundError: 请求的资源未找到
  • BanklessRateLimitError: API 调用频率限制

使用教程

使用依赖

  1. 安装 Node.js 和 npm
  2. 获取 Bankless API 令牌

安装教程

npm install @bankless/onchain-mcp

环境设置

export BANKLESS_API_TOKEN=your_api_token_here

运行服务器

npx @bankless/onchain-mcp

调试方式

npm run debug

从源代码构建

git clone https://github.com/Bankless/onchain-mcp.git
cd onchain-mcp
npm install
npm run build

许可证

该项目遵循 MIT 开源许可条款。