Multichain MCP Server 🌐

🏗️ Built and maintained by Oraichain Labs

A comprehensive toolkit for building and deploying AI agents with blockchain capabilities. This monorepo includes:

• A Model Context Protocol (MCP) server for AI applications
• Agent development tools for blockchain interactions
• Development kit for building custom AI agents

About Oraichain Labs

Oraichain Labs is the team behind Oraichain, the world's first AI Layer 1 for Web3. We specialize in AI Agents and blockchain technologies:

• Autonomous Web3 AI Agents
• Decentralized AI Marketplace
• AI Oracle System
• Multichain DeFi protocols

Contributors

Thanks goes to these wonderful people:

<a href="https://github.com/oraichain/multichain-mcp/graphs/contributors"> <img src="https://contrib.rocks/image?repo=oraichain/multichain-mcp" /> </a>

Overview

This project provides a complete suite of tools for AI-blockchain integration:

MCP Server

• Interact with multiple blockchain networks
• Retrieve wallet addresses and balances
• Transfer funds and manage tokens
• Deploy and interact with smart contracts
• Bridge assets between networks

Agent Tools

• Ready-to-use blockchain interaction tools
• Multi-chain support out of the box
• DeFi protocol integrations
• Secure transaction handling

Agent Development Kit

• Build custom AI agents with blockchain capabilities
• Extensible interfaces and types
• Best practices and examples
• Testing utilities

The entire toolkit is built using TypeScript and supports multiple blockchain networks through a unified interface.

Prerequisites

• Node.js (v18 or higher)
• pnpm (v9.0.0 or higher)
• Wallet configuration for supported networks
• API keys for supported networks (optional)

Installing Prerequisites

1. Install Node.js:

   • Visit Node.js official website
   • Download and install the LTS version (v18 or higher)
   • Verify installation:

     node --version
     npm --version
     

2. Install pnpm:

   # Using npm
   npm install -g pnpm
   
   # Verify installation
   pnpm --version
   

   For alternative installation methods, visit pnpm installation guide.

Installation

Clone this repository:

git clone https://github.com/oraichain/multichain-mcp.git
cd multichain-mcp

Install dependencies:

pnpm install

Build the project:

pnpm build

Configuration

Create a .env file with your configuration:

# Server Configuration
PORT=4000 # Optional, defaults to 4000

# Network RPC URLs
RPC_URL=your_rpc_url # Optional, defaults to https://rpc.orai.io

Development

To develop all packages, run:

pnpm dev

To build all packages:

pnpm build

To run tests:

pnpm test

Project Structure

This is a monorepo using Turborepo and pnpm workspaces. Here's the structure:

• packages/
  • mcp-server/: The core MCP server implementation
  • agent-tools/: Collection of blockchain interaction tools for AI agents
  • agent-kit/: Development kit for building AI agents with blockchain capabilities

Each package serves a specific purpose:

MCP Server

The main server package that implements the Model Context Protocol for blockchain interactions. It provides the core functionality for handling requests from AI clients.

Agent Tools

A collection of tools specifically designed for AI agents to interact with various blockchain networks. These tools are used by the MCP server to execute blockchain operations.

Agent Kit

A development kit that helps developers build AI agents with blockchain capabilities. It includes utilities, types, and interfaces for consistent agent development.

Integration with AI Tools

Claude Desktop Integration

To add this MCP server to Claude Desktop:

1. Create or edit the Claude Desktop configuration file at:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add the following configuration:

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": ["-y", "@oraichain/mcp-server@0.0.21"],
      "env": {
        "RPC_URL": "https://rpc.orai.io"
      }
    }
  }
}

3. Restart Claude Desktop for the changes to take effect.

📜 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

💬 Community

• GitHub Discussions
• Discord

⭐ Support

If you find Multichain MCP useful, please consider starring the repository and contributing new features or improvements!