SOON Blockchain

🚀 SVM-MCP: SOON Model Context Protocol Server

An MCP (Model Context Protocol) server integrating Claude AI with SOON and other SVM-based blockchains. This server offers tools to check balances, retrieve recent transactions, and view token holdings, suitable for both the testnet and mainnet of SOON, covering account balances, transactions, and token holdings.

🚀 Quick Start

This MCP server aims to connect Claude with the SOON ecosystem, enabling it to:

• Query wallet balances on the testnet and mainnet.
• Retrieve the latest transactions of an address.
• Check the token holdings of any account.

The current implementation uses SOON's RPC endpoints but can be easily modified to work with any Solana-compatible blockchain or different blockchains.

✨ Features

• Balance Check: By providing an address, the server returns the balance of that address on the testnet and mainnet.
• Recent Transactions: By providing an address, the server returns the recent transaction records of that address.
• Token Holdings: By providing an address, the server returns all the tokens held by that address and their detailed information.

📦 Prerequisites

• Node.js: Node.js and npm (version 14 or higher) need to be installed.
• Yarn: Alternatively, use the Yarn package manager.
• SOON Network Knowledge: Understand how to interact with the Solana network.

📦 Installation

1. Clone this repository:

   git clone https://github.com/yourusername/svm-mcp.git
   cd svm-mcp
   

2. Install dependencies:

   npm install
   # Or use yarn
   yarn install
   

3. Start the server:
   • Compile the project:

     npm run build
     # Or use yarn
     yarn build
     

   • Run the built file:

     node build/index.js
     

📚 Project Structure

• src/index.ts: The main entry point of the project, initializing the server and connections.
• src/tools/: Contains utility functions for interacting with the blockchain.
• build/: The output directory generated by compilation.

💻 Usage Examples

Basic Usage

Balance Check Tool

async function getBalance(address: string, connection: Connection) {
  try {
    const balance = await connection.getBalance(new PublicKey(address));
    return `${balance} SOL`;
  } catch (error) {
    throw new Error(`无法获取余额：${error.message}`);
  }
}

Recent Transactions Tool

async function getRecentTransactions(address: string, connection: Connection) {
  try {
    const transactions = await connection.getSignaturesForAddress([new PublicKey(address)]);
    return transactions;
  } catch (error) {
    throw new Error(`无法获取交易：${error.message}`);
  }
}

Token Holdings Tool

async function getToken Holdings(address: string, connection: Connection) {
  try {
    const tokenAccounts = await connection.getTokenAccountsByOwner(new PublicKey(address), {
      programId: new PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"),
    });
    return tokenAccounts;
  } catch (error) {
    throw new Error(`无法获取代币持有量：${error.message}`);
  }
}

Server Initialization

async function main() {
  try {
    console.log("启动 MCP 服务器...");
    const transport = new StdioServerTransport();
    console.log("传输已初始化，正在连接到服务器...");
    await server.connect(transport);
    console.log("服务器连接成功");
    // 服务器将保持在此状态运行
  } catch (error) {
    console.error("连接服务器时出错：", error);
    process.exit(1);
  }
}

main().catch((err) => {
  console.error("启动服务器时出错：", err);
  process.exit(1);
});

📚 Documentation

Claude Desktop Configuration

To use this MCP server in Claude Desktop, add the following content to the claude_desktop_config.json file:

{
  "mcpServers": {
    "svm-mcp": {
      "command": "bun",
      "args": ["/path/to/svm-mcp/build/index.js"]
    }
  }
}

Custom RPC Endpoints

To use different RPC endpoints or connect to other blockchains, edit the endpoint URLs in src/index.ts:

const connectionTestnet = new Connection("YOUR_TESTNET_RPC_URL");
const connectionMainnet = new Connection("YOUR_MAINNET_RPC_URL");

Usage with Claude

Once the MCP server is running and connected to Claude, you can use the following commands:

Check Address Balance

你能检查这个 SOON 测试网地址的余额吗：<address>

Get Recent Transactions

<address> 在 SOON 测试网上做的最近一笔交易是什么？

View Token Holdings

<address> 在 SOON 主网上持有的有哪些代币？

📄 License

We would like to express our gratitude to the following projects and platforms:

• Anthropic Claude for providing AI capabilities.
• Model Context Protocol for tool integration.
• Solana Web3.js for blockchain interaction.
• SOON Network for blockchain support.