Sui Dev Mcp

by Hzzy2O

328 downloads

Not rated

GitHub

About

Sui Dev Mcp is a Model Context Protocol server for Sui blockchain integration. It provides Sui Move development, blockchain interaction, and debugging capabilities within MCP‑compatible IDEs like Cursor.

Details

Author: Hzzy2O
Downloads: 328
Categories: Other, Developer Tools

- Switch between testnet, mainnet, and devnet environments
- Parse and display human‑readable Move module interfaces
- Create test wallets with pre‑funded SUI tokens
- Decode error codes with fix suggestions
- Analyze transaction gas usage and recommend optimizations
- Generate Sui Explorer links for transactions, addresses, and objects

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Sui Dev Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

From the repository

Install Node.js 18+, clone the repository, run npm install, copy .env.example to .env, build with npm run build, and start with npm start. Integrate with Cursor IDE by adding the server’s startup script in Cursor’s MCP settings.

`sui_network`

Manage Sui network settings and get network information (current network: testnet)

`sui_wallet`

Manage Sui wallets and tokens (current network: testnet)

`sui_objects`

Query and manage Sui objects (current network: testnet)

`sui_transactions`

Execute and query Sui transactions (current network: testnet)

`sui_contracts`

Interact with Sui smart contracts (current network: testnet)

`sui_explorer`

Get Sui Explorer links for objects, addresses, or transactions (current network: testnet)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "sui dev mcp": {
            "sui-tools": {
                "command": "npx",
                "args": [
                    "-y",
                    "sui-dev-mcp@latest"
                ]
            }
        }
    }
}

McpServers

{
    "sui-tools": {
        "command": "npx",
        "args": [
            "-y",
            "sui-dev-mcp@latest"
        ]
    }
}

Sui MCP Server

English | 中文

A Model Context Protocol (MCP) server for Sui blockchain integration, providing seamless Sui Move development, blockchain interaction, and debugging capabilities within Cursor IDE.

Sui MCP Server Features

This project implements an MCP server specifically for Sui blockchain development and data querying, seamlessly integrating Sui's powerful features into MCP-compatible IDEs like Cursor.

Sui Development Environment Management

- Environment Switching: Easily switch between testnet, mainnet, and devnet environments - Network Status Monitoring: Track network health, version, and TPS - Network Time: Get blockchain network time for time-dependent operations

Smart Contract Development

- Contract Interface Parser: Parse and display human-readable Move module Interfaces - Contract Verification: Verify and publish smart contract source code

Blockchain Interaction

- Wallet Management: Create test wallets with pre-funded SUI tokens - Faucet Integration: Request test tokens for development - Object Explorer: Retrieve and inspect Sui objects - Transaction Builder: Build transactions from high-level descriptions - Token Standards Support: Recognize and parse different token standards

Debugging & Optimization

- Error Decoding: Translate error codes into human-readable explanations with fix suggestions - Gas Analysis: Analyze transaction gas usage and recommend optimizations

Ecosystem Integration

- Explorer Integration: Generate links to Sui Explorer for transactions, addresses, and objects

Installation

Prerequisites

- Node.js 18+

Setup

1. Clone the repository

git clone https://github.com/your-username/sui-mcp-server.git

cd sui-mcp-server

2. Install dependencies

npm install

3. Configure environment

cp .env.example .env

Edit the .env file according to your needs.

4. Build the server

npm run build

Usage

Starting the server

npm start

Integration with Cursor IDE

Once properly configured, the Sui MCP server will automatically connect with Cursor IDE. To add the MCP server in Cursor:
1. Open Cursor
2. Go to File -> Preferences -> Cursor Settings -> Features -> MCP Server
3. Add a new MCP server pointing to this project's startup script

Available MCP Tools

Development Environment

- sui_switch_env: Switch between network environments - sui_network_status: Check network status - sui_network_time: Get current network time

Smart Contract Development

- sui_get_contract_interface_doc: Extract and format contract Interface - sui_get_module_interface: Get Interface for a specific module - sui_get_contract_source: Retrieve contract source - sui_get_contract_interface: Get complete contract documentation - sui_get_package_interface: Get raw Interface for a smart contract package

Chain Interaction

- sui_create_new_wallet: Create new wallets (works across networks) - sui_fund_dev_coins: Request development coins - sui_get_object: Get object details - sui_get_objects: Get details of multiple Sui objects by their IDs - sui_get_owned_objects: Get objects owned by a specific address - sui_build_transaction: Build transactions - sui_get_transaction: Get details of a specific transaction - sui_get_address_transactions: Get transaction history for a specific address

Token Management

- sui_get_token_metadata: Get metadata for a specific token type - sui_get_all_token_balances: Get all token balances for a specific address

Debugging & Optimization

- sui_decode_error: Decode error messages - sui_gas_advisor: Analyze gas usage

Ecosystem Integration

- sui_explorer_lookup: Get Sui Explorer links

Example Usage in Cursor

```typescript
// Get Sui network status
const status = await mcp.callTool("sui_network_status", {
random_string: "any"
});
console.log(status);

// Create a test wallet
const wallet = await mcp.callTool("sui_create_new_wallet", {
network: "testnet"
});
console.log(wallet);

// Get contract Interface
const abi = await mcp.callTool("sui_get_contract_interface", {
packageId: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
format: "markdown"
});
console.log(abi);

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

sui_network

sui_wallet

sui_objects

sui_transactions

sui_contracts

sui_explorer

Claude Desktop / Cursor

McpServers

Sui MCP Server

Sui MCP Server Features

Sui Development Environment Management

Smart Contract Development

Blockchain Interaction

Debugging & Optimization

Ecosystem Integration

Installation

Prerequisites

Setup

Usage

Starting the server

Integration with Cursor IDE

Available MCP Tools

Development Environment

Smart Contract Development

Chain Interaction

Token Management

Debugging & Optimization

Ecosystem Integration

Example Usage in Cursor

Contributing

License

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive

`sui_network`

`sui_wallet`

`sui_objects`

`sui_transactions`

`sui_contracts`

`sui_explorer`