返回 MCP 目录
public公开dns本地运行

onchain-mcp

Bankless链上MCP服务器为区块链数据交互提供框架,通过Bankless API实现智能合约状态读取、事件查询和交易分析等功能。

article

README

🚀 Bankless Onchain MCP 服务器

Bankless Onchain MCP 服务器是一款强大的工具,可在多个区块链网络中进行链上数据分析与处理。借助该服务器,能轻松获取并解析不同区块链平台的交易记录、合约交互等信息。

🚀 快速开始

📦 安装指南

安装所需依赖:

npm install @bankless/onchain-mcp

初始化配置

在项目中引入以下代码,即可开始使用 Bankless Onchain MCP 服务:

const { BanklessMCP } = require('@bankless/onchain-mcp');

// 初始化 MCP 服务器
const mcpServer = new BanklessMCP({
  // 配置项可以根据具体需求进行调整
});

// 启动服务
mcpServer.start().catch(console.error);

✨ 主要特性

1. 链上数据无银行化处理

  • 特点:无需传统金融中介,直接在链上完成数据的读写与分析。
  • 功能
    • 支持多区块链网络(如 Ethereum、BSC、Polygon 等)。
    • 提供统一的 API 接口,简化跨链操作。

2. 链上日志分析

  • 特点:通过日志解析技术,提取和分析链上事件数据。
  • 功能
    • 自动识别合约地址及其相关事件。
    • 支持复杂查询,如时间范围、特定地址的交易记录等。

3. 智能合约反编译

  • 特点:将部署在区块链上的二进制合约代码反编译为可读的源代码。
  • 功能
    • 提供多种语言支持(如Solidity)。
    • 自动生成ABI(应用二进制接口)以方便调用。

4. 链上价格数据聚合

  • 特点:实时获取和处理链上代币的价格数据。
  • 功能
    • 支持多平台代币的行情查看。
    • 提供历史数据分析工具,便于研究市场趋势。

📚 详细文档

从源代码构建

# 克隆仓库
git clone https://github.com/Bankless/onchain-mcp.git
cd onchain-mcp

# 安装依赖
npm install

# 构建项目
npm run build

调试模式

npm run debug

🔧 技术细节

错误处理

该服务器提供了多种错误类型以帮助您快速定位问题:

  • BanklessValidationError:输入参数无效。
  • BanklessAuthenticationError:认证失败或 API 令牌问题。
  • BanklessResourceNotFoundError:请求的资源未找到。
  • BanklessRateLimitError:超过 API 调用限制。

集成与 AI 模型

为了将此服务器集成到支持 MCP 的 AI 应用中,请在您的服务配置中添加以下内容:

{
  "mcpServers": {
    "banklessOnchain": {
      "type": "BanklessMCP",
      "options": {
        // 根据具体需求填写选项
      }
    }
  }
}

💡 使用建议

  • 日志查询优化:使用过滤器和聚合功能提升日志处理效率。
  • 跨链操作:善用统一 API 接口简化多链数据管理。

📄 许可证

Bankless Onchain MCP 服务器遵循 MIT 许可证,允许您自由使用、修改及分发此代码。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端