AI导哈

Sui区块链MCP服务器

一个全面的Sui区块链MCP服务器，提供53种工具，包括钱包管理、DeFi、SuiNS、质押、验证器、Move智能合约等，通过GraphQL和JSON-RPC双传输协议支持。

  • by ExpertVagabond
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ExpertVagabond/sui-mcp-server

使用说明

sui-mcp服务器

最全面的Sui区块链MCP服务器。 53个具有GraphQL+JSON-RPC双重传输的工具——钱包、DeFi（Cetus、DeepBook）、SuiNS、质押、验证器、Move自检和完整的Sui RPC表面。

竞争对手提供10-15种基本操作工具。该服务器在一个包中覆盖了整个Sui生态系统。

安装

npx sui-mcp-server

或全局安装：

npm install -g sui-mcp-server
sui-mcp-server

配置

添加到MCP配置(claude_desktop_config.json 或 ~/.mcp.json):

{
  "mcpServers": {
    "sui": {
      "command": "npx",
      "args": ["-y", "sui-mcp-server"]
    }
  }
}

不需要API密钥--直接连接到Sui公共RPC节点。

工具（53）

钱包管理（4）

工具 描述 关键参数
create_wallet 创建新的Ed25519密钥对（仅在内存中，不持久） --
import_wallet 从Bech32编码的私钥导入(suiprivkey...) privateKey
list_wallets 列出当前会话中的所有钱包 --
get_balance 获取任何地址的SUI余额 address

硬币操作（4）

工具 描述 关键参数
get_all_balances 地址的所有硬币余额（SUI+其他硬币类型） address
get_coins 地址拥有的特定类型的硬币对象 address, coinType
get_coin_metadata 硬币类型的元数据（名称、符号、小数） coinType
get_total_supply 硬币类型的总流通供应量 coinType

转账（4）

工具 描述 关键参数
transfer_sui 在地址之间转移SUI（金额以SUI表示，而非MIST） from, to, amount
transfer_objects 将一个或多个对象转移给收件人 from, objectIds, to
merge_coins 将多个硬币合并为一个（处理气体冲突） walletName, coinType
split_coins 将一枚硬币分割成多枚硬币 walletName, coinId, amounts

对象查询（5）

工具 描述 关键参数
get_object 按ID列出的任何链上对象的完整详细信息 objectId
get_owned_objects 具有可选类型筛选的地址所拥有的对象 address, type
get_dynamic_fields 对象（桌子、袋子）的动态字段 parentId
multi_get_objects 一次调用最多可批量提取50个对象 objectIds
get_object_history 追踪所有涉及特定对象的交易 objectId

交易（4）

工具 描述 关键参数
get_transaction 按摘要列出完整的交易详细信息 digest
dry_run_transaction 无需执行即可预览效果的模拟运行 txBytes
query_transactions 按发件人、收件人、对象或移动功能搜索 filter
get_total_transactions 网络上的总交易计数 --

移动智能合约（7）

工具 描述 关键参数
move_call 执行Move函数调用 walletName, target, arguments
dev_inspect 模拟Move呼叫而不执行（不需要钱包） sender, target, arguments
get_normalized_module 完整移动模块定义（函数、结构） package, module
get_move_function 移动函数详细信息（参数、返回类型、可见性） package, module, function
get_move_struct 移动结构定义（字段、能力） package, module, struct
get_package_modules 列出Move包中的所有模块 package
get_move_call_metrics 全网络移动呼叫指标 --

打桩（4）

工具 描述 关键参数
get_stakes 地址的所有质押位置 address
request_add_stake 用验证器抵押SUI walletName, amount, validator
request_withdraw_stake 撤回SUI walletName, stakedSuiId
get_validators 包含APY、佣金和赌注金额的完整验证器集 --

活动（1）

工具 描述 关键参数
query_events 按类型、发件人、包或摘要查询链事件 filter

网络与分析（9）

工具 描述 关键参数
switch_network 在主网、测试网、开发网、本地网之间切换 network
get_network_info 链ID、纪元、天然气价格、最新检查点 --
get_latest_checkpoint 最新检查点序列号 --
get_reference_gas_price MIST当前参考天然气价格 --
get_checkpoint 按序列号列出的详细检查点数据 sequenceNumber
get_epoch_info 历史时代数据（时间、赌注、气体摘要） epoch
get_protocol_config Sui协议配置（限制、功能） --
get_system_state 全系统状态：纪元、验证器、存储资金 --
get_committee_info 任何纪元的验证器委员会信息 epoch

SuiNS域名服务（4）

工具 描述 关键参数
resolve_name 解决 example.sui 到隋的地址 name
resolve_address 将地址反向解析为SuiNS名称 address
suins_get_name_record 全名记录——NFT ID、目标、过期、元数据 name
suins_get_price 按名称长度列出的注册和续订定价 length

DeFi：Cetus DEX（2）

工具 描述 关键参数
cetus_get_pools 按硬币类型查询Cetus CLMM池 coinTypeA, coinTypeB
cetus_get_pool 特定Cetus池的详细池数据 poolId

DeFi：深度书（1）

工具 描述 关键参数
deepbook_get_pool DeepBook v3订单簿数据——池状态和动态字段 poolId

DeFi：令牌工具（3）

工具 描述 关键参数
get_token_price 通过查询DeFi池储备确定代币价格 token
swap_quote 通过模拟池来交换报价 tokenIn, tokenOut, amount
list_common_tokens 具有完整硬币类型地址的普通Sui代币 --

水龙头（1）

工具 描述 关键参数
request_faucet 从水龙头请求SUI（仅限devnet和testnet） address

为什么是这个？

  • 53个工具vs 10-15个。 像0xdwong/sui-mcp这样的竞争对手涵盖了基本操作。该服务器包括DeFi（Cetus、DeepBook）、SuiNS、Move自省、质押、验证器和完整分析。
  • GraphQL+JSON-RPC双传输。 建立在官方 @mysten/sui v2.11 SDK @mysten/suins 用于名称服务——面向未来的GraphQL迁移。
  • 端到端测试。 59个通过devnet、testnet和主网的测试。钱包创建、转账、质押、DeFi查询、SuiNS解析和Move检查都经过验证。

令牌快捷方式

使用符号快捷方式而不是完整的硬币类型地址：

快捷方式 完整硬币类型
SUI 0x2::sui::SUI
USDC 0xdba34672e...::usdc::USDC
USDT 0xc060006111...::coin::COIN
WETH 0xaf8cd5edc1...::coin::COIN
DEEP 0xdeeb7a4662...::deep::DEEP

网络

开始 国际信息发展组织 默认情况下。随时切换 switch_network:

网络 RPC端点
mainnet https://fullnode.mainnet.sui.io:443
testnet https://fullnode.testnet.sui.io:443
devnet https://fullnode.devnet.sui.io:443
localnet http://127.0.0.1:9000

安全

  • 密钥仅存储在内存中，从不写入磁盘，也从不记录
  • 从所有错误消息中编辑私钥
  • 速率限制：120次通话/分钟（滑动窗口）
  • 所有输入均已Zod严格模式验证

发展

git clone https://github.com/ExpertVagabond/sui-mcp-server.git
cd sui-mcp-server
npm install
npm run build
npm start

许可证

麻省理工学院-- 马修·卡斯滕 / 紫松鼠传媒

相关 MCP