Claude デスクトップ用 Agentipy MCP サーバー

Claude AIにオンチェーンツールを提供するModel Context Protocol（MCP）サーバー。標準化されたインターフェースを介してSolanaブロックチェーンとやり取りできます。この実装はAgentipyを使用し、AIエージェントがブロックチェーン操作をシームレスに実行できるようにします。

概要

この MCP サーバーは、次のツールを提供することで Claude の機能を拡張します。

• Solanaブロックチェーンとやりとりする

• トランザクションを実行する

• アカウント情報の照会

• Solanaウォレットを管理する

• 価格予測を取得する

• トークンの取引とステーク

• 新しいトークンを展開する

• CoinGeckoからトークン情報を取得する

• deBridgeを使用してクロスチェーンブリッジ取引を実行する

• Pyth Networkからリアルタイムの価格データを取得する

• CoinGeckoから包括的なトークン情報にアクセス

• トレンドのトークンとプールを監視する

• 上昇銘柄と市場動向を追跡

• 詳細なトークン価格データと分析を入手

サーバーは、AI エージェントのブロックチェーン相互作用を標準化するために、モデル コンテキスト プロトコル仕様を実装します。

Related MCP server: Solana Agent Kit MCP Server

前提条件

• Python 3.8以上

• クロードデスクトップがインストール済み

• 秘密鍵付きSolanaウォレット

• Solana RPC URL (メインネット、テストネット、または開発ネット)

• OpenAI APIキー（オプション）

• Allora APIキー（オプション）

• CoinGecko Pro APIキー（オプション）

インストール

オプション 1: クイックインストール (推奨)

# Clone the repository
git clone https://github.com/niceberginc/agentipy-mcp
cd agentipy-mcp

# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`

# Install dependencies
pip install -r requirements.txt

オプション2: 手動セットアップ

1. 仮想環境を作成します。

python -m venv .venv
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`

2. 必要なパッケージをインストールします。

pip install agentipy>=2.0.8 cryptography>=3.4.7 python-dotenv>=0.17.1 web3>=7.8.0 allora_sdk>=0.2.0 mcp>=1.4.0

構成

環境設定

資格情報を使用して.envファイルを作成します。

# Solana Configuration
SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here

# Optional API Keys
OPENAI_API_KEY=your_openai_api_key
ALLORA_API_KEY=your_allora_api_key
COINGECKO_PRO_API_KEY=your_coingecko_api_key

Claude Desktopとの統合

この MCP サーバーを Claude Desktop に追加するには、次の手順に従います。

1. Claudeデスクトップ構成ファイルを見つける

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/Claude\claude_desktop_config.json

2. 構成を追加する構成ファイルを作成または編集し、次の JSON を追加します。

   注： commandフィールドには、Unix/Macシステムの場合はrun_mcp.sh 、Windowsシステムの場合はrun_mcp.batを使用してください。システム上のスクリプトファイルへの正しい絶対パスを使用してください。

   {
     "mcpServers": {
       "agentipy": {
         "command": "/path/to/your/run_mcp.sh",  # Replace with .bat for Windows
         "env": {
           "RPC_URL": "your_solana_rpc_url_here",
           "SOLANA_PRIVATE_KEY": "your_private_key_here",
           "OPENAI_API_KEY": "your_openai_api_key",
           "ALLORA_API_KEY": "your_allora_api_key",
           "COINGECKO_PRO_API_KEY": "your_coingecko_api_key"
         },
         "disabled": false,
         "autoApprove": ["GET_BALANCE", "GET_PRICE_PREDICTION"]
       }
     }
   }

3. **Claude Desktop を再起動します。**これらの変更を行った後、設定を有効にするために Claude Desktop を再起動します。

プロジェクト構造

agentipy-mcp/
├── server.py          # Main entry point
├── run_mcp.sh         # Run script for Unix/Mac
├── run_mcp.bat        # Run script for Windows
├── requirements.txt   # Dependencies
└── .env              # Environment variables

利用可能なツール

MCP サーバーは、次のブロックチェーン ツールを提供します。

ネイティブSolanaアクション

• GET_BALANCE - ウォレットの残高を確認する

• TRANSFER - ウォレット間でトークンを転送する

• DEPLOY_TOKEN - Solanaに新しいトークンをデプロイする

アローラアクション

• GET_PRICE_PREDICTION - 価格予測を取得する

• GET_ALL_TOPICS - 利用可能なトピックを取得する

木星の行動

• STAKE_WITH_JUP - Jupiterを使用してトークンをステークする

• TRADE_WITH_JUP - Jupiterを使用してトークンを取引する

デブリッジアクション

• CREATE_DEBRIDGE_TRANSACTION - deBridge Liquidity Network API を使用してクロスチェーンブリッジトランザクションを作成する

• EXECUTE_DEBRIDGE_TRANSACTION - deBridge Liquidity Network APIを使用してクロスチェーンブリッジトランザクションを実行する

• CHECK_TRANSACTION_STATUS - deBridge Liquidity Network API を使用してクロスチェーンブリッジ取引のステータスを確認します

Pythonアクション

• PYTH_GET_PRICE - Pythからコインの価格を取得する

CoinGeckoアクション

• COINGECKO_GET_TOKEN_INFO - CoinGeckoからトークン情報を取得する

• COINGECKO_GET_COIN_PRICE_VS - Coingeckoから特定の通貨のコインの価格を取得します

• COINGECKO_GET_TOP_GAINERS - Coingecko からトップゲイン銘柄を取得

• COINGECTO_GET_TRENDING_POOLS - Coingeckoからトレンドプールを取得します

• COINGECKO_GET_TRENDING_TOKENS - Coingeckoからトレンドのトークンを取得する

• COINGECKO_GET_TOKEN_PRICE_DATA - Coingeckoからトークン価格データを取得する

• COINGECKO_GET_LATEST_POOLS - Coingecko から最新のプールを取得します

セキュリティに関する考慮事項

• 秘密鍵を安全に保管し、決して共有しないでください

• 機密情報には環境変数を使用する

• AIエージェントの運用には専用のウォレットの使用を検討してください

• AIエージェントの活動を定期的に監視および監査する

• メインネットの前に開発ネット/テストネットでテスト運用

トラブルシューティング

問題が発生した場合:

1. Solanaの秘密鍵が正しいことを確認する

2. RPC URL にアクセスできるかどうかを確認してください

3. すべての依存関係が正しくインストールされていることを確認する

4. .envファイルに正しい資格情報が含まれていることを確認してください

5. Claude Desktop のログでエラーメッセージを確認してください

依存関係

主な依存関係は次のとおりです。

• agentipy - Solanaブロックチェーンインタラクション

• python-dotenv - 環境管理

• mcp - モデルコンテキストプロトコル

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。