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

Pythonバージョンライセンス: MIT

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: 手動セットアップ

仮想環境を作成します。

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

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

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 に追加するには、次の手順に従います。

Claudeデスクトップ構成ファイルを見つける
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude\claude_desktop_config.json

構成を追加する構成ファイルを作成または編集し、次の 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"]
    }
  }
}

**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エージェントの活動を定期的に監視および監査する
メインネットの前に開発ネット/テストネットでテスト運用

トラブルシューティング

問題が発生した場合:

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

依存関係

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

agentipy - Solanaブロックチェーンインタラクション
python-dotenv - 環境管理
mcp - モデルコンテキストプロトコル

貢献

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

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

ライセンス

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

Agentipy MCP Server for Claude Desktop