区块链接口服务

UluCoreMCP是一个为Algorand和Voi网络提供的低级区块链接口服务器,支持账户/资产/应用检查、交易搜索、区块检索、TEAL编译和交易模拟等核心功能。

  • by NautilusOSS
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 NautilusOSS/UluCoreMCP

使用说明

核心MCP

用于Algorand和Voi网络的低级区块链接口MCP服务器。

提供链基元:账户/资产/应用程序检查、交易搜索、区块检索、TEAL编译和交易模拟。

设置

npm install

用法

node index.js

添加到客户端

{
  "mcpServers": {
    "ulu-core-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/UluCoreMCP/index.js"]
    }
  }
}

支持的网络

网络 链
algorand-mainnet 阿尔戈朗
voi-mainnet Voi

默认端点使用 Nodely 公共API。通过覆盖 ULU_CORE_NETWORKS 环境变量:

{
  "algorand-mainnet": {
    "chain": "algorand",
    "algodUrl": "https://your-algod-url",
    "algodToken": "",
    "indexerUrl": "https://your-indexer-url",
    "indexerToken": ""
  }
}

工具

网络

  • get_network_status --节点状态(最后一轮,同步状态)
  • get_suggested_params --建议的交易参数
  • get_block --按轮次划分的块信息

账户/资产/应用程序

  • 获取计数 --账户信息(余额、资产、身份验证地址)
  • 获取资产 --按ID列出的资产信息
  • 获取应用程序 --应用程序信息(全局状态、程序)
  • get_application_boxes --列出应用程序框
  • get_application_box --按名称获取特定框(base64)

交易

  • get_transaction --按ID查找已确认的交易
  • get_ending_transaction --待处理交易信息
  • 搜索交易 --使用过滤器搜索(地址、资产、应用程序、舍入范围、时间范围、类型)
  • get_transaction_group --组中的所有交易

公用事业

  • 解码交易 --将未签名的交易字节解码为JSON
  • 解密_签名_交易 --将签名的交易字节解码为JSON
  • 模拟交易 --无需广播即可模拟交易
  • compile_teal --将TEAL源代码编译为字节码
  • 反汇编 --将TEAL字节码反汇编到源代码

建筑

index.js              MCP server + tool registration
lib/
  config.js           Network configuration loader
  errors.js           Error handling utilities
  networks.js         Algod/Indexer client manager
  algod.js            Algod wrapper functions
  indexer.js          Indexer wrapper functions
  normalize.js        Response normalization (BigInt → string, Uint8Array → base64)

设计

UluCoreMCP返回 事实而不是解释。原始链数据被规范化以确保JSON安全(BigInt变为字符串,字节数组变为base64),但在其他方面未经修改地传递。

特定于协议的逻辑、生态系统约定、钱包管理和交易签名属于更高层的MCP。

局限性

  • 只读:无签名、无广播、无钱包管理
  • 仅限Algorand/Voi(两者都使用相同的AVM客户端逻辑)
  • 事务组检索获取一轮中的所有事务,并按组ID进行筛选
  • 盒子名称必须采用base64编码