sui -wallet-management

This MCP server provides wallet management, balance queries, object operations, and transaction capabilities for the Sui network. Once running, you can access a suite of tools such as creating and importing wallets, querying SUI balances and object ownership, transferring SUI or objects, and switching between networks. The server exposes a set of MCP endpoints that map to wallet operations (create_wallet, import_wallet, list_wallets, get_wallet_address, export_wallet), balance and object operations (get_balance, get_all_balances, get_objects, get_object_details), transaction operations (transfer_sui, transfer_object, get_transaction, get_transactions, get_wallet_transactions), network and gas operations (switch_network, get_network_info, get_chain_id, get_gas_price, request_tokens_from_faucet), validator information (get_validators, get_validator_info), and utility functions (validate_address, normalize_address, convert_mist_to_sui, convert_sui_to_mist). To get started, install the server globally, then run the CLI to start the MCP server and begin issuing MCP calls to manage wallets, query balances, and perform transactions on your chosen Sui network.

Prerequisites:

• Node.js (LTS) and npm installed on your machine
• Git (optional, for cloning the repository)

Installation steps:

1. Install the MCP server globally via npm:

   npm install -g @ExpertVagabond/sui-mcp-server

2. Verify installation by running the CLI (you should see usage/help text):

   sui-mcp-server --help

3. Create a configuration file if you want explicit settings, or rely on environment variables. Example environment variables can include SUI_NETWORK and PORT as placeholders in your runtime environment.

If you prefer to run via npx (without global install), you can also invoke:

npx -y @ExpertVagabond/sui-mcp-server

4. (Optional) Build steps if you clone the repository locally:

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

5. Start the server using the npm package or the built artifact as appropriate for your setup.

Notes and tips:

• Security: The server stores private keys in memory during runtime. Consider using secure storage and access controls in production.
• Network configuration: Use SUI_NETWORK to switch between mainnet, testnet, devnet, or localnet. Ensure faucet access for test/dev networks when needed.
• Environment variables: You can override defaults via environment variables (for example, SUI_NETWORK, PORT). Documented endpoints will adapt to these settings.
• Dependencies: This server relies on @mysten/sui for Sui interactions, @modelcontextprotocol/sdk for MCP plumbing, and crypto libraries like bip39 and ed25519-hd-key for wallet functionality.
• Versioning: Check CHANGELOG for release notes and breaking changes between versions.