Mit dem Ping Agent Kit erstellter MCP-Server

Ein Model Context Protocol (MCP)-Server bietet On-Chain-Tools für KI und ermöglicht eine nahtlose Interaktion mit der Solana-Blockchain über eine standardisierte Schnittstelle. Diese Implementierung basiert auf dem Ping Agent Kit und ermöglicht KI-Agenten die effiziente Ausführung von Blockchain-Operationen.

Überblick

Dieser MCP-Server erweitert Claudes Fähigkeiten, indem er Tools für Folgendes bereitstellt:

• Interagieren Sie mit der Solana-Blockchain

• Transaktionen ausführen

• Kontoinformationen abfragen

• Solana-Wallets verwalten

Der Server implementiert die Model Context Protocol-Spezifikation, um Blockchain-Interaktionen für KI-Agenten zu standardisieren.

Related MCP server: Solana MCP Server

Voraussetzungen

• Node.js (v16 oder höher)

• pnpm (empfohlen), npm oder yarn

• Solana-Wallet mit privatem Schlüssel

• Solana RPC-URL (Mainnet, Testnet oder Devnet)

Installation

Option 1: Von npm installieren (empfohlen für Clients wie Cursor/Cline)

# Install globally
npm install -g ping-mcp

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

Option 2: Aus der Quelle erstellen

1. Klonen Sie dieses Repository:

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

2. Installieren Sie Abhängigkeiten:

pnpm install

3. Erstellen Sie das Projekt:

pnpm run build

Konfiguration

Umgebungs-Setup

Erstellen Sie eine .env Datei mit Ihren Anmeldeinformationen:

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

Integration mit Claude Desktop

Um diesen MCP-Server zu Claude Desktop hinzuzufügen, führen Sie die folgenden Schritte aus:

1. Suchen Sie die Claude Desktop-Konfigurationsdatei

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

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

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

2. Fügen Sie die Konfiguration hinzu. Erstellen oder bearbeiten Sie die Konfigurationsdatei und fügen Sie das folgende JSON hinzu:

   Wenn Sie über npm installiert haben (Option 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": []
       }
     }
   }

   Wenn Sie aus der Quelle erstellt haben (Option 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. Starten Sie Claude Desktop neu. Starten Sie Claude Desktop nach diesen Änderungen neu, damit die Konfiguration wirksam wird.

Projektstruktur

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

Verfügbare Tools

Der MCP-Server bietet die folgenden Solana-Blockchain-Tools:

• GET_ASSET – Informationen zu einem Solana-Asset/Token abrufen

• DEPLOY_TOKEN – Stellen Sie ein neues Token auf Solana bereit

• GET_PRICE - Preisinformationen für Token abrufen

• WALLET_ADDRESS - Holen Sie sich die Wallet-Adresse

• BALANCE - Wallet-Guthaben prüfen

• TRANSFER - Token zwischen Wallets übertragen

• MINT_NFT – Neue NFTs erstellen und prägen

• TRADE - Token-Trades ausführen

• REQUEST_FUNDS – Geldmittel anfordern (nützlich für Tests/Entwicklung)

• RESOLVE_DOMAIN – Solana-Domänennamen auflösen

• GET_TPS – Aktuelle Transaktionen pro Sekunde auf Solana abrufen

Sicherheitsüberlegungen

• Bewahren Sie Ihren privaten Schlüssel sicher auf und geben Sie ihn niemals weiter

• Verwenden Sie Umgebungsvariablen für vertrauliche Informationen

• Erwägen Sie die Verwendung einer dedizierten Wallet für KI-Agentenoperationen

• Regelmäßige Überwachung und Prüfung der Aktivitäten von KI-Agenten

• Testvorgänge im Devnet/Testnet vor dem Mainnet

Fehlerbehebung

Wenn Probleme auftreten:

1. Überprüfen Sie, ob Ihr privater Solana-Schlüssel korrekt ist

2. Überprüfen Sie, ob Ihre RPC-URL zugänglich ist

3. Stellen Sie sicher, dass Sie sich im vorgesehenen Netzwerk befinden (Mainnet, Testnet oder Devnet).

4. Überprüfen Sie die Claude Desktop-Protokolle auf Fehlermeldungen

5. Überprüfen Sie, ob der Build erfolgreich war

Abhängigkeiten

Zu den wichtigsten Abhängigkeiten gehören:

• @solana/web3.js

• @modelcontextprotocol/sdk

• Ping-Agent-Kit

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

1. Forken Sie das Repository

2. Erstellen Sie Ihren Feature-Zweig ( git checkout -b feature/amazing-feature )

3. Übernehmen Sie Ihre Änderungen ( git commit -m 'Add some amazing feature' )

4. Pushen zum Zweig ( git push origin feature/amazing-feature )

5. Öffnen einer Pull-Anfrage

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.