Sui Mcp Server

io.github.ExpertVagabond由 GitHub 账号 ExpertVagabond 发布v0.4.2更新于 Oct 25, 2026

53-tool MCP server for Sui blockchain — wallets, DeFi, Move contracts, staking, SuiNS, analytics

已验证STDIO仅桌面金融开发者工具

概览

AI 生成的概览

一个本地 MCP 服务器，为 Sui 区块链提供 53 个工具，让助手管理钱包、转账与质押 SUI、查看 Move 合约并查询链上数据。

可以做什么
创建、导入并列出内存中的钱包，查询地址与币种的余额、代币和代币元数据。转账 SUI 与对象，合并和拆分代币。查询对象、动态字段、对象历史、交易和链上事件。查看 Move 包、模块、函数与结构体，执行或试运行 Move 调用。质押与赎回质押、列出验证者，读取网络、纪元、检查点、Gas 与委员会数据。解析 SuiNS 名称与价格，查询 Cetus 与 DeepBook 池、获取代币价格与兑换报价，并在 devnet 或 testnet 上领取水龙头资金。
适用场景
适合助手需要读取或操作 Sui 链上数据的场景：查看余额与交易、检查 Move 合约、探索 DeFi 池与报价，或用会话钱包执行转账和质押。适合希望用一个服务器覆盖钱包、质押、SuiNS 与分析，而不必安装多个窄范围服务器的 Sui 开发者和用户。
运行要求
通过 stdio 在本地运行，通常使用 npx sui-mcp-server 或全局 npm 安装，因此需要 Node.js 以及访问 Sui RPC 端点的网络连接。无需 API 密钥，连接公共 Sui 节点。默认从 devnet 启动，可切换到 mainnet、testnet、devnet 或 localnet。
安装前请注意
部分工具会动用资金：转账、合并与拆分代币、质押、赎回和 Move 调用都会在链上执行并可能消耗 Gas。导入钱包需要 Bech32 私钥，新建钱包仅在本次会话的内存中存在。默认网络为 devnet，但切换到 mainnet 后操作即为真实交易，建议先试运行或 dev-inspect。请求会发送到公共 Sui RPC 节点。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Sui Mcp Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

sui-mcp-server

[npm version] [License: MIT] [Node] [Tools]

The most comprehensive Sui blockchain MCP server. 53 tools with GraphQL + JSON-RPC dual transport -- wallets, DeFi (Cetus, DeepBook), SuiNS, staking, validators, Move introspection, and the full Sui RPC surface.

Competitors offer 10-15 tools for basic operations. This server covers the entire Sui ecosystem in a single package.

Install

bash
npx sui-mcp-server

Or install globally:

bash
npm install -g sui-mcp-serversui-mcp-server

Configure

Add to your MCP config (claude_desktop_config.json or ~/.mcp.json):

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

No API key required -- connects directly to Sui public RPC nodes.

Tools (53)

Wallet Management (4)

ToolDescriptionKey Params
create_walletCreate a new Ed25519 keypair (in-memory only, not persisted)--
import_walletImport from a Bech32-encoded private key (suiprivkey...)privateKey
list_walletsList all wallets in the current session--
get_balanceGet SUI balance for any addressaddress

Coin Operations (4)

ToolDescriptionKey Params
get_all_balancesAll coin balances for an address (SUI + other coin types)address
get_coinsCoin objects of a specific type owned by an addressaddress, coinType
get_coin_metadataMetadata for a coin type (name, symbol, decimals)coinType
get_total_supplyTotal circulating supply of a coin typecoinType

Transfers (4)

ToolDescriptionKey Params
transfer_suiTransfer SUI between addresses (amount in SUI, not MIST)from, to, amount
transfer_objectsTransfer one or more objects to a recipientfrom, objectIds, to
merge_coinsMerge multiple coins into one (handles gas conflicts)walletName, coinType
split_coinsSplit a coin into multiple coinswalletName, coinId, amounts

Object Queries (5)

ToolDescriptionKey Params
get_objectFull details of any on-chain object by IDobjectId
get_owned_objectsObjects owned by an address with optional type filteringaddress, type
get_dynamic_fieldsDynamic fields of an object (tables, bags)parentId
multi_get_objectsBatch-fetch up to 50 objects in one callobjectIds
get_object_historyTrace all transactions that touched a given objectobjectId

Transactions (4)

ToolDescriptionKey Params
get_transactionFull transaction details by digestdigest
dry_run_transactionDry-run to preview effects without executingtxBytes
query_transactionsSearch by sender, recipient, object, or Move functionfilter
get_total_transactionsTotal transaction count on the network--

Move Smart Contracts (7)

ToolDescriptionKey Params
move_callExecute a Move function callwalletName, target, arguments
dev_inspectSimulate a Move call without executing (no wallet needed)sender, target, arguments
get_normalized_moduleFull Move module definition (functions, structs)package, module
get_move_functionMove function details (params, return types, visibility)package, module, function
get_move_structMove struct definition (fields, abilities)package, module, struct
get_package_modulesList all modules in a Move packagepackage
get_move_call_metricsNetwork-wide Move call metrics--

Staking (4)

ToolDescriptionKey Params
get_stakesAll staking positions for an addressaddress
request_add_stakeStake SUI with a validatorwalletName, amount, validator
request_withdraw_stakeWithdraw staked SUIwalletName, stakedSuiId
get_validatorsFull validator set with APY, commission, and stake amounts--

Events (1)

ToolDescriptionKey Params
query_eventsQuery on-chain events by type, sender, package, or digestfilter

Network & Analytics (9)

ToolDescriptionKey Params
switch_networkSwitch between mainnet, testnet, devnet, localnetnetwork
get_network_infoChain ID, epoch, gas price, latest checkpoint--
get_latest_checkpointLatest checkpoint sequence number--
get_reference_gas_priceCurrent reference gas price in MIST--
get_checkpointDetailed checkpoint data by sequence numbersequenceNumber
get_epoch_infoHistorical epoch data (times, stakes, gas summaries)epoch
get_protocol_configSui protocol configuration (limits, features)--
get_system_stateFull system state: epoch, validators, storage fund--
get_committee_infoValidator committee info for any epochepoch

SuiNS Name Service (4)

ToolDescriptionKey Params
resolve_nameResolve example.sui to a Sui addressname
resolve_addressReverse-resolve an address to SuiNS name(s)address
suins_get_name_recordFull name record -- NFT ID, target, expiration, metadataname
suins_get_priceRegistration and renewal pricing by name lengthlength

DeFi: Cetus DEX (2)

ToolDescriptionKey Params
cetus_get_poolsQuery Cetus CLMM pools by coin typescoinTypeA, coinTypeB
cetus_get_poolDetailed pool data for a specific Cetus poolpoolId

DeFi: DeepBook (1)

ToolDescriptionKey Params
deepbook_get_poolDeepBook v3 order book data -- pool state and dynamic fieldspoolId

DeFi: Token Tools (3)

ToolDescriptionKey Params
get_token_priceToken price by querying DeFi pool reservestoken
swap_quoteSwap quote by simulating against a pooltokenIn, tokenOut, amount
list_common_tokensCommon Sui tokens with full coin type addresses--

Faucet (1)

ToolDescriptionKey Params
request_faucetRequest SUI from faucet (devnet and testnet only)address

Why This One?

  • 53 tools vs 10-15. Competitors like 0xdwong/sui-mcp cover basic operations. This server includes DeFi (Cetus, DeepBook), SuiNS, Move introspection, staking, validators, and full analytics.
  • GraphQL + JSON-RPC dual transport. Built on the official @mysten/sui v2.11 SDK with @mysten/suins for name service -- future-proofed for the GraphQL migration.
  • Tested end-to-end. 59 passing tests across devnet, testnet, and mainnet. Wallet creation, transfers, staking, DeFi queries, SuiNS resolution, and Move inspection all verified.

Token Shortcuts

Use symbol shortcuts instead of full coin type addresses:

ShortcutFull Coin Type
SUI0x2::sui::SUI
USDC0xdba34672e...::usdc::USDC
USDT0xc060006111...::coin::COIN
WETH0xaf8cd5edc1...::coin::COIN
DEEP0xdeeb7a4662...::deep::DEEP

Networks

Starts on devnet by default. Switch at any time with switch_network:

NetworkRPC Endpoint
mainnethttps://fullnode.mainnet.sui.io:443
testnethttps://fullnode.testnet.sui.io:443
devnethttps://fullnode.devnet.sui.io:443
localnethttp://127.0.0.1:9000

Security

  • Keys are in-memory only -- never written to disk, never logged
  • Private keys redacted from all error messages
  • Rate limiting: 120 calls/minute (sliding window)
  • All inputs validated with Zod strict schemas

Development

bash
git clone https://github.com/ExpertVagabond/sui-mcp-server.gitcd sui-mcp-servernpm installnpm run buildnpm start

License

MIT -- Matthew Karsten / Purple Squirrel Media

来源：README.md，提交 39d0d65

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.4.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分