SOON Blockchain

🚀 SVM - MCP：SOON モデルコンテキストプロトコルサーバ

このサーバは、Claude AI と SOON およびその他の SVM ベースのブロックチェーンを統合するモデルコンテキストプロトコル（MCP）サーバです。SOON のテストネットとメインネットにおけるアカウント残高、取引、トークン保有量を対象に、残高の確認、最新取引の取得、トークン保有量の表示などのツールを提供します。

🚀 クイックスタート

SVM - MCP サーバは、Claude と SOON エコシステムを接続することを目的としています。これにより、テストネットとメインネットのウォレット残高の照会、アドレスの最新取引の取得、任意のアカウントのトークン保有量の確認が可能になります。

✨ 主な機能

• 残高確認：アドレスを指定することで、テストネットとメインネットにおけるそのアドレスの残高を返します。
• 最新取引：アドレスを指定することで、そのアドレスの最新取引記録を返します。
• トークン保有量：アドレスを指定することで、そのアドレスが保有するすべてのトークンとその詳細情報を返します。

📦 インストール

前提条件

• 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/：コンパイルによって生成される出力ディレクトリです。

ツール実装

残高確認ツール

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

設定

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 主网上持有的有哪些代币？

📄 ライセンス

謝辞

• Anthropic Claude：AI 機能を提供しています。
• モデルコンテキストプロトコル：ツールの統合に使用されています。
• Solana Web3.js：ブロックチェーンとのやり取りに使用されています。
• SOON ネットワーク：ブロックチェーンのサポートを提供しています。