Pingエージェントキットで構築されたMCPサーバー

AI向けのオンチェーンツールを提供するモデルコンテキストプロトコル（MCP）サーバー。標準化されたインターフェースを介してSolanaブロックチェーンとのシームレスな連携を可能にします。Ping Agent Kit上に構築されたこの実装により、AIエージェントはブロックチェーン操作を効率的に実行できます。

概要

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

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

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

• アカウント情報の照会

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

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

Related MCP server: Solana MCP Server

前提条件

• Node.js (v16 以上)

• pnpm（推奨）、npm、またはyarn

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

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

インストール

オプション 1: npm からインストールする (Cursor/Cline などのクライアントに推奨)

# Install globally
npm install -g ping-mcp

# Or install locally in your project
npm install ping-mcp

オプション2: ソースからビルドする

1. このリポジトリをクローンします:

git clone https://github.com/PingAIFun/ping-mcp.git
cd ping-mcp

2. 依存関係をインストールします:

pnpm install

3. プロジェクトをビルドします。

pnpm run build

構成

環境設定

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

# Solana Configuration
SOLANA_PRIVATE_KEY=your_private_key_here
RPC_URL=your_solana_rpc_url_here
OPENAI_API_KEY=your_openai_api_key # OPTIONAL

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 を追加します。

   npm 経由でインストールした場合 (オプション 1):

   {
     "mcpServers": {
       "solana-mcp": {
         "command": "npx",
         "args": ["ping-mcp"],
         "env": {
           "RPC_URL": "your_solana_rpc_url_here",
           "SOLANA_PRIVATE_KEY": "your_private_key_here",
           "OPENAI_API_KEY": "your_openai_api_key"  // OPTIONAL
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }

   ソースからビルドした場合 (オプション 2):

   {
     "mcpServers": {
       "solana-mcp": {
         "command": "node",
         "args": ["/path/to/ping-mcp/build/index.js"],
         "env": {
           "RPC_URL": "your_solana_rpc_url_here",
           "SOLANA_PRIVATE_KEY": "your_private_key_here",
           "OPENAI_API_KEY": "your_openai_api_key"  // OPTIONAL
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }

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

プロジェクト構造

ping-agent-kit-mcp/
├── src/
│   ├── index.ts          # Main entry point
├── package.json
└── tsconfig.json

利用可能なツール

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

• GET_ASSET - Solanaアセット/トークンに関する情報を取得する

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

• GET_PRICE - トークンの価格情報を取得する

• WALLET_ADDRESS - ウォレットアドレスを取得する

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

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

• MINT_NFT - 新しいNFTを作成して発行する

• TRADE - トークン取引を実行する

• REQUEST_FUNDS - 資金をリクエストする（テスト/開発に役立ちます）

• RESOLVE_DOMAIN - Solanaドメイン名を解決する

• GET_TPS - Solana の現在の 1 秒あたりのトランザクション数を取得します。

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

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

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

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

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

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

トラブルシューティング

問題が発生した場合:

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

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

3. 目的のネットワーク（メインネット、テストネット、または devnet）に接続していることを確認します

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

5. ビルドが成功したことを確認する

依存関係

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

• @solana/web3.js

• @モデルコンテキストプロトコル/sdk

• pingエージェントキット

貢献

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

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 ライセンスに基づいてライセンスされています。