AMOCA Solana MCP Server

by manolaz
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Integrates Mermaid diagram support for visualizing system architecture and workflow components, as shown in the README flowchart of the AMOCA system.

  • Utilizes Shields.io badges in the documentation to display project status and compatibility information.

  • Provides comprehensive RPC tools for Solana blockchain development, including account operations, wallet management, transaction analysis, storage calculations, and on-chain validations.

AMOCA(自律型メリットオンチェーンエージェント)

このリポジトリは、モデル コンテキスト プロトコル (MCP) 上に構築された、Solana 開発用の Autonomous Merit On Chain Agent (AMOCA) の実装を示します。

目次

AMOCAとは何ですか?

AMOCA(Autonomous Merit On Chain Agent)は、標準化されたインターフェースを通じてSolanaブロックチェーン開発に高度な機能を提供するインテリジェントエージェントです。この実装では、以下の点が実証されています。

  1. Solanaの包括的なRPCメソッド:
    • 基本的なアカウント操作(getBalance、getAccountInfo、getTransaction)
    • オンチェーンストレージの計算 (getMinimumBalanceForRentExemption)
    • ウォレット操作(createWallet、importWallet)
  2. DeFi取引機能:
    • トークン残高の確認(単一トークンとポートフォリオ全体の分析)
    • USDベースのヒストグラムによるトークン価値分布の視覚化
    • Jupiter API の価格データによるポートフォリオ価値の追跡
    • トークンスワップのためのJupiter API統合
    • 見積もり取得とスワップ実行
  3. Solana開発に役立つ自律ワークフロー:
    • トランザクション分析プロンプト(障害診断、コストの内訳)
    • ストレージコストの計算
    • Solanaのインストールとクラスターに関するドキュメントへのアクセス
  4. オンチェーンオペレーションのメリットベースの検証と検証

特徴

  • Solana RPCツール: アカウント情報の照会、残高の確認、取引の分析
  • ウォレット管理: Solanaウォレットの作成とインポート
  • 取引ツール:トークンスワップの実行、トークン価格の確認、ポートフォリオの分析
  • Helius API統合: Heliusの強力なAPIを活用してSolanaデータアクセスを強化します

Solana モデルコンテキストプロトコル (MCP)

このリポジトリは、Solana 開発用のモデル コンテキスト プロトコル (MCP) サーバーのシンプルな実装を示します。

MCPとは何ですか?

モデルコンテキストプロトコル(MCP)は、AIモデルがツールやリソースとやり取りするための標準化されたインターフェースです。このデモでは、以下の機能を提供するシンプルなMCPサーバー実装を紹介します。

  1. Solana の基本的な RPC メソッド (getBalance、getAccountInfo、getTransaction)
  2. Solana開発に役立つヒント

前提条件

  • Node.js(v16以上を推奨)
  • pnpm パッケージ マネージャー (v9.10.0 または互換)
  • Solana CLI (オプションだが推奨)

インストール

このリポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/manolaz/amoca-solana-mcp-server.git cd solana-dev-mcp pnpm install

このサーバーを MCP インスペクターで実行するには、次を使用します。

npx @modelcontextprotocol/inspector ts-node index.ts

はじめる

  1. 環境変数を設定する: API キーを使用して、 .env.exampleテンプレートに基づいて.envファイルを作成します。
cp .env.example .env # Edit .env with your API keys
  1. コードを調べる: 主な実装はindex.tsにあり、シンプルなフェッチ ツールといくつかのプロンプトを使用して MCP サーバーをセットアップします。
  2. サーバーの変更: ツール、リソース、プロンプトを追加してサーバーを拡張できます。
  3. 実装をテストする: テスト スイートを実行して、すべてが正しく動作していることを確認します。
pnpm test

使用例

このセクションでは、 Claudeで Solana MCP サーバーを使用する方法について説明します。Windsurf とCursorで Solana MCP サーバー使用する場合も、同じ手順に従ってください。

設定ファイルを生成する

このSolana MCPサーバーを使用するには、Claudeがサーバーに接続するために使用する設定ファイルを生成する必要があります。設定ファイルを生成するには、以下のいずれかのコマンドを実行します。

  • ts-nodeがグローバルにインストールされている場合はpnpm generate-config
  • ts-nodeがグローバルにインストールされていない場合はpnpm build && pnpm generate-config:js

これにより、次の内容の JSON 構成が出力されます。

ts-nodeをお持ちの場合:

{ "mcpServers": { "solana-dev": { "command": "ts-node", "args": ["<full-path-to-repo>/index.ts"] } } }

ts-nodeがグローバルにインストールされていない場合:

{ "mcpServers": { "solana-dev": { "command": "node", "args": ["<full-path-to-repo>/dist/index.js"] } } }

クロードとAMOCAを使う

プロジェクト構造

  • index.ts - メインサーバーの実装
  • package.json - プロジェクトの依存関係とメタデータ
  • tsconfig.json - TypeScript 設定

Solana開発のためのMCP拡張のアイデア

このMCPサーバー実装は、Solana開発のニーズに合わせて拡張またはフォークできる基盤を提供します。以下に、開発を始めるためのヒントをいくつかご紹介します。

拡張のアイデア

  1. 優先手数料推定ツール:Solanaの最近のネットワークアクティビティに基づいて、最適な優先手数料を推定するツールを追加します。これにより、ユーザーはタイムリーな処理を確保しながらトランザクションコストを最適化できるようになります。
  2. Solana Verify Debugger : 検証プロセスに関するより詳細な情報を提供することでsolana-verifyの問題のデバッグに役立つツールを作成します。
  3. Solana Security.txt インスペクター: 特定の Solana プログラムの security.txt ファイル情報を抽出して表示するツールを構築し、セキュリティ上の懸念事項についてプログラムのメンテナーに簡単に連絡できるようにします。
  4. プログラム展開用の Squads ヘルパー: Solana プログラムの展開とアップグレードのプロセスを自動化するツールを作成し、複数の環境にわたるプログラムの状態の管理を容易にします。
  5. Anchor-Error Explainer : エラー コードを受け取り、Anchor エラー コード データベースから対応する人間が判読できるエラー メッセージを検索するツールを開発します。
  6. 強化されたプロンプト:サーバーのプロンプト機能を拡張し、Solana開発タスクにおいて、より状況に応じた提案を提供します。例えば、一般的なトランザクションパターン、アカウント作成、トークン操作などのプロンプトを追加できます。
  7. トランザクション ビルダー: 複数の命令を含む複雑なトランザクションの構築を支援するツールを作成し、さまざまな Solana プログラムとの対話を容易にします。
  8. カスタム RPC エンドポイント: プライベート RPC プロバイダーまたはローカル バリデーターのサポートを含む、カスタム RPC エンドポイントの構成を許可します。
  9. プログラム展開ヘルパー: Solana プログラムの展開とアップグレードのプロセスを簡素化するツールを作成します。
  10. アカウント&トランザクションエクスプローラー:アカウントIDまたはトランザクションIDを取得し、エクスプローラービューに似た、人間が読める形式で内容を表示するツールを追加します。これは、データを手動でデコードすることなく、トランザクションデータやアカウントの状態を検査するのに役立ちます。
  11. Solana、Anchor、およびProtocolのドキュメント:Solana、Anchor、およびProtocolのドキュメントをMCPエディタに直接読み込むリソースを追加することで、エディタを離れることなく関連情報に簡単にアクセスできるようになります。これは、それぞれのリポジトリからドキュメントを取得し、MCPサーバーからリソースとして提供することで実装できます。

貢献方法

他の人に役立つ可能性のある拡張機能を作成した場合は、このリポジトリにプルリクエストを送信することを検討してください。以下のガイドラインに従ってください。

  1. コードをきちんと文書化しておく
  2. 新しい機能のテストを含める
  3. 既存のコードスタイルに従う
  4. 追加した内容でREADMEを更新します

Helius API ツール

このプロジェクトは、強力な Solana データ アクセスのためにさまざまな Helius API エンドポイントを統合します。

デジタル アセット スタンダード (DAS) API

道具説明
getAssetsByOwner特定のアドレスが所有するNFTを取得する
getAsset特定のNFTのIDで詳細情報を取得する
getAssetsByGroup特定のグループ(コレクションなど)に属するアセットを取得する
searchAssets複雑なクエリパラメータを使用してアセットを検索する
getAssetProof圧縮されたNFTのマークル証明を取得する
getAssetsByCreator特定のクリエイターアドレスによって作成されたアセットを取得する
getAssetsByAuthority更新権限アドレスで資産を取得する
getNftEditionsマスターエディションNFTのすべてのエディションを入手する

コレクションとミントAPI

道具説明
getMintlistコレクションのミントリストを取得する

Webhook管理

道具説明
getAllWebhooksHelius APIキーのすべてのWebhookを取得する
getWebhookByIDWebhook IDでWebhookの詳細を取得する
createWebhookアドレスアクティビティ監視用の新しいWebhookを作成する
createCollectionWebhookNFTコレクションを監視するためのWebhookを作成する
deleteWebhookID で Webhook を削除する

ネットワークとユーティリティツール

道具説明
getCurrentTPSSolanaの1秒あたりの現在のトランザクション数を取得する
getTokenHoldersミントアドレスで特定のトークンの保有者を取得する
getPriorityFeeEstimate取引の優先手数料の見積もりを取得する
getStakeAccounts所有者のアドレスでステークアカウントを取得する
getComputeUnits消費された計算ユニットの合計を取得するためにトランザクションをシミュレートする

強化されたプロンプト

サーバーには、一般的な Helius 関連のタスク用の特別なプロンプトが含まれています。

プロンプト説明
collection-analysisNFTコレクションの詳細な分析を取得する
monitor-nft-collectionNFTコレクションアクティビティを監視するためのWebhookを設定する
network-statusSolanaネットワークのステータス情報を取得する

使用例

アドレスが所有するNFTを取得する

const response = await server.tools.getAssetsByOwner({ ownerAddress: "GoodboiNft5iFNhbgKkf1RX2VdMqKvt5xYxyVh3zf9okx", });

NFTコレクションを分析する

const response = await server.prompts["collection-analysis"]({ collectionAddress: "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w", });

ネットワークステータスの監視

const response = await server.prompts["network-status"]({});

ライセンス

マサチューセッツ工科大学

-
security - not tested
A
license - permissive license
-
quality - not tested

AI モデルが Solana ブロックチェーンと対話できるようにし、RPC メソッド、ウォレット管理、DeFi 取引機能、および Helius API 統合を提供して Solana 開発を強化するモデル コンテキスト プロトコル サーバー。

  1. Table of Contents
    1. What is AMOCA?
      1. Features
        1. Solana Model Context Protocol (MCP)
          1. What is MCP?
        2. Prerequisites
          1. Installation
            1. Getting Started
              1. Example Usage
                1. Generate the configuration file
                2. Using AMOCA with Claude
              2. Project Structure
                1. Ideas Extending MCP for Solana Development
                  1. Ideas for Extension
                  2. How to Contribute
                2. Helius API Tools
                  1. Digital Asset Standard (DAS) API
                  2. Collection & Mint API
                  3. Webhook Management
                  4. Network & Utility Tools
                3. Enhanced Prompts
                  1. Usage Examples
                    1. Get NFTs Owned by an Address
                    2. Analyze an NFT Collection
                    3. Monitor Network Status
                  2. License
                    ID: 45zdw9yqs7