MCP3 Monorepo

by sentioxyz

2 stars
128 downloads
Not rated
GitHub

About

MCP3 Monorepo contains implementations of the Model Context Protocol (MCP) for different blockchain networks. It provides tools and services for blockchain data access and interaction, including packages for Sui, Ethereum, and data integrations like DexScreener and DeFiLlama.

Details

Author
sentioxyz
GitHub stars
2
Downloads
128
Categories
Other

- Unified CLI with tool command for all sub-project tools
- Sui blockchain tools (wallets, Cetus, Navi protocols)
- Ethereum implementation of MCP
- DexScreener and DeFiLlama API integrations
- Transaction server and React UI component library
- Shared utilities via @mcp3/common package

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP3 Monorepo
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install and configure via the CLI tool npx @mcp3/sui. For Claude Desktop, add the configuration to your claude_desktop_config.json using the command npx -y @mcp3/sui start -t. Use the CLI with npx @mcp3/sui --help to list all commands, or npx @mcp3/sui tool <tool-name> to run a specific tool.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "mcp3 monorepo": {
            "mcp3-sui": {
                "command": "npx",
                "args": [
                    "-y",
                    "@mcp3/sui",
                    "start",
                    "-t"
                ]
            }
        }
    }
}

McpServers

{
    "mcp3-sui": {
        "command": "npx",
        "args": [
            "-y",
            "@mcp3/sui",
            "start",
            "-t"
        ]
    }
}

MCP3 Monorepo

GitHub

This monorepo contains implementations of the Model Context Protocol for different blockchain networks, providing tools and services for blockchain data access and interaction.

How to use MCP3 for SUI

MCP3 provides a comprehensive suite of tools for interacting with the Sui blockchain. The main package @mcp3/sui offers a CLI and API for common operations, while specialized packages provide additional functionality for specific protocols and use cases.

Claude Desktop Quick Start

Add following to your claude desktop config

{
...
"mcpServers": {
...
"mcp3-sui": {
"command": "npx",
"args": [
"-y",
"@mcp3/sui",
"start",
"-t"
]
}
...
}
}

Use CLI

For a list of available commands and options, run:

npx @mcp3/sui --help

Using the Tool Command

MCP3 provides a unified tool command that organizes all tools from sub-projects as subcommands. To see all available tools, run:

npx @mcp3/sui tool

This will display a list of all available tools grouped by their prefix (e.g., sui-cetus, sui-wallets, etc.).

To run a specific tool, use:

npx @mcp3/sui tool <tool-name> [options]

For example:

npx @mcp3/sui tool sui-wallets-list
npx @mcp3/sui tool sui-cetus-pool-list

Packages

Core Packages

- @mcp3/common: Shared utilities, types, and tools used across all implementations - @mcp3/eth: Ethereum implementation of the Model Context Protocol - @mcp3/sui: Sui Network implementation of the Model Context Protocol

Sui Ecosystem Packages

- @mcp3/sui-base: Base utilities and tools for Sui Network - @mcp3/sui-wallets: Wallet management tools for Sui Network - @mcp3/sui-cetus: Cetus Protocol integration for Sui Network - @mcp3/sui-navi: Navi Protocol integration for Sui Network

Data Integration Packages

- @mcp3/dex-screener: DexScreener API integration for MCP3 - @mcp3/defilama: DeFiLlama API integration for MCP3

Transaction Management

- @mcp3/transaction-server: Server for handling transactions and serving the transaction UI - @mcp3/transaction-ui: React component library for transaction signing and submission

Development

This project uses pnpm as the package manager and workspaces for managing the monorepo.

CLI Structure

MCP3 uses a unified CLI structure where:

1. All tools from sub-projects are registered as subcommands of a main tool command
2. When no specific tool is named, the CLI automatically lists all available tools
3. Tools are grouped by their prefix for better organization
4. Tools are only accessible through the tool command

When implementing new tools:

1. Register your tool using registration.addTool() in your package
2. Create a callback function that registers all tools in your package
3. Pass this callback to the startCli function as the second parameter

Example:

// Create a callback function to register tools
const registerTools = async (reg: Registration) => {
    // Register your tools
    registerYourTools(reg);
};

// Register tools immediately for the main CLI
registerTools(registration);

// Pass the callback to startCli
startCli(registration, registerTools);

Prerequisites

- Node.js (v18 or higher)
- pnpm (v8 or higher)

Setup

```bash

No reviews yet — be the first

Sign in to leave a review

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

Email sign in

No reviews posted yet.