SOON Blockchain

🚀 SVM - MCP：SOON 模型上下文協議服務器

SVM - MCP 是一個集成了 Claude AI 與 SOON 及其他基於 SVM 的區塊鏈的模型上下文協議（MCP）服務器。它提供了一系列實用工具，可用於檢查餘額、獲取最近交易以及查看代幣持有量，適用於 SOON 的測試網和主網，涵蓋賬戶餘額、交易和代幣持有量等信息。

🚀 快速開始

此 MCP 服務器旨在連接 Claude 與 SOON 生態系統，使其能夠查詢測試網和主網的錢包餘額、獲取地址的最新交易以及檢查任何賬戶的代幣持有量。當前實現使用了 SOON 的 RPC 端點，但可輕鬆修改以適用於任何 Solana 兼容區塊鏈或不同的區塊鏈。

✨ 主要特性

• 餘額檢查：通過提供一個地址，服務器返回該地址在測試網和主網上的餘額。
• 最新交易：通過提供一個地址，服務器返回該地址的最近交易記錄。
• 代幣持有量：通過提供一個地址，服務器返回該地址持有的所有代幣及其詳細信息。

📦 安裝指南

先決條件

• Node.js：需要安裝 Node.js 和 npm（版本 14 或更高）。
• Yarn：或者使用 Yarn 包管理器。
• SOON 網絡知識：瞭解如何與 Solana 網絡交互。

具體步驟

1. 克隆此倉庫：

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

2. 安裝依賴項：

   npm install
   # 或者使用 yarn
   yarn install
   

3. 啟動服務器：
   • 編譯項目：

     npm run build
     # 或者使用 yarn
     yarn build
     

   • 運行構建後的文件：

     node build/index.js
     

📚 詳細文檔

項目結構

• src/index.ts：項目的主入口，初始化服務器和連接。
• src/tools/：包含與區塊鏈交互的工具函數。
• build/：編譯生成的輸出目錄。

配置

Claude Desktop 配置

要在 Claude Desktop 中使用此 MCP 服務器，將以下內容添加到 claude_desktop_config.json 文件中：

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

自定義 RPC 端點

要使用不同的 RPC 端點或連接到其他區塊鏈，編輯 src/index.ts 中的端點 URL：

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

使用方法與 Claude

一旦 MCP 服務器運行並連接到 Claude，您可以使用以下命令：

• 檢查地址餘額

你能檢查這個 SOON 測試網地址的餘額嗎：<address>

• 獲取最近交易

<address> 在 SOON 測試網上做的最近一筆交易是什麼？

• 查看代幣持有量

<address> 在 SOON 主網上持有的有哪些代幣？

💻 使用示例

基礎用法

餘額檢查工具

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}`);
  }
}

最新交易工具

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}`);
  }
}

代幣持有量工具

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}`);
  }
}

高級用法

服務器初始化

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);
});

致謝

• Anthropic Claude 提供 AI 功能
• 模型上下文協議 用於工具集成
• Solana Web3.js 用於區塊鏈交互
• SOON 網絡 提供區塊鏈支持