核心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 |
默认端点使用 公共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编码