Agentipy Mcp Server

Claude Desktop 向け Agentipy MCP サーバー

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

概要

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

• Solana ブロックチェーンとのやり取り
• トランザクションの実行
• アカウント情報の照会
• Solana ウォレットの管理
• 価格予測の取得
• トークンの取引とステーキング
• 新しいトークンのデプロイ
• CoinGecko からのトークン情報の取得
• deBridge を使用したクロスチェーンブリッジトランザクションの実行
• Pyth Network からのリアルタイム価格データの取得
• CoinGecko からの包括的なトークン情報へのアクセス
• トレンドのトークンとプールの監視
• 値上がり上位のトークンと市場の動向の追跡
• 詳細なトークン価格データと分析の取得

このサーバーは Model Context Protocol の仕様を実装し、AI エージェントによるブロックチェーン操作を標準化します。

前提条件

• Python 3.8 以上
• Claude Desktop がインストール済みであること
• 秘密鍵を持つ Solana ウォレット
• Solana RPC URL（mainnet、testnet、または devnet）
• OpenAI API Key（任意）
• Allora API Key（任意）
• CoinGecko Pro API Key（任意）

インストール

オプション 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 Desktop の設定ファイルを確認します

   • 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 上に新しいトークンをデプロイします

Allora アクション

• GET_PRICE_PREDICTION - 価格予測を取得します
• GET_ALL_TOPICS - 利用可能なトピックを取得します

Jupiter アクション

• STAKE_WITH_JUP - Jupiter を使用してトークンをステーキングします
• TRADE_WITH_JUP - Jupiter を使用してトークンを取引します

DeBridge アクション

• CREATE_DEBRIDGE_TRANSACTION - deBridge Liquidity Network API を使用してクロスチェーンブリッジトランザクションを作成します
• EXECUTE_DEBRIDGE_TRANSACTION - deBridge Liquidity Network API を使用してクロスチェーンブリッジトランザクションを実行します
• CHECK_TRANSACTION_STATUS - deBridge Liquidity Network API を使用してクロスチェーンブリッジトランザクションのステータスを確認します

Pyth アクション

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

CoinGecko Actions

• 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 エージェントのアクティビティを定期的に監視し、監査してください
• メインネットで実行する前に、devnet/testnetで操作をテストしてください

トラブルシューティング

問題が発生した場合は、次の手順を確認してください。

1. Solanaの秘密鍵が正しいことを確認します
2. RPC URLにアクセスできることを確認します
3. すべての依存関係が正しくインストールされていることを確認します
4. .envファイルに正しい認証情報が含まれていることを確認します
5. Claude Desktopのログにエラーメッセージがないか確認します

依存関係

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

• agentipy - Solanaブロックチェーンとの連携
• python-dotenv - 環境管理
• mcp - Model Context Protocol

コントリビューション

コントリビューションを歓迎します。お気軽にPull Requestを送信してください。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. Pull Requestを作成します

ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。