Provides access to Solana blockchain data, allowing AI agents to query wallet balances, transaction history, token prices, DeFi yields from Raydium and Orca, and perform token safety checks.
Solana MCP Server
MCP-Server der AI-Agents Zugriff auf Solana-Blockchain-Daten gibt: Wallet-Balances, Token-Preise, DeFi-Yields und Sicherheitschecks.
Features
Tool | Beschreibung |
| SOL- und Token-Balances einer Wallet abfragen |
| Letzte Transaktionen einer Wallet (Enhanced Transactions) |
| Aktueller Token-Preis via Jupiter (CoinGecko als Fallback) |
| Token-Metadaten: Name, Symbol, Supply, Decimals |
| Top DeFi-Pool-APYs von Raydium und Orca |
| Yield-Vergleich für einen bestimmten Token über mehrere Protokolle |
| Sicherheitscheck: RugCheck-Score, Holder-Konzentration, Authorities |
Schnellstart
1. Repository klonen und einrichten
git clone https://github.com/AiAgentKarl/solana-mcp-server.git
cd solana-mcp-server
# Virtual Environment erstellen
python -m venv .venv
# Aktivieren
# Windows:
.venv\Scripts\activate
# Linux/Mac:
source .venv/bin/activate
# Dependencies installieren
pip install -r requirements.txt2. API-Keys besorgen
API | URL | Kosten | Benötigt? |
Helius | Kostenlos (1M Credits/Mo) | Ja | |
Jupiter | Kostenlos | Ja | |
CoinGecko | — | Kostenlos (30 Calls/Min) | Nein (kein Key nötig) |
Raydium | — | Kostenlos | Nein (kein Key nötig) |
Orca | — | Kostenlos | Nein (kein Key nötig) |
RugCheck | — | Kostenlos | Nein (API öffentlich) |
3. Environment-Datei anlegen
Erstelle eine .env oder keys.env im Projektordner:
HELIUS_API_KEY=dein-helius-key
JUPITER_API_KEY=dein-jupiter-key4. Server starten
# Mit MCP Inspector testen (Web-UI zum Ausprobieren)
mcp dev src/server.py
# Oder direkt starten (stdio-Transport)
python -m src.serverIntegration
Claude Code / Claude Desktop
Erstelle eine .mcp.json im Projektordner (oder claude_desktop_config.json für Claude Desktop):
{
"mcpServers": {
"solana": {
"type": "stdio",
"command": "python",
"args": ["-m", "src.server"],
"env": {
"HELIUS_API_KEY": "dein-helius-key",
"JUPITER_API_KEY": "dein-jupiter-key"
}
}
}
}Andere MCP-Clients
Der Server nutzt den stdio-Transport (Standard MCP). Jeder MCP-kompatible Client kann ihn einbinden — einfach python -m src.server als Kommando konfigurieren.
Architektur
src/
├── server.py # FastMCP Server — registriert alle Tools
├── config.py # Lädt API-Keys aus .env, Settings via Pydantic
├── clients/ # Ein async HTTP-Client pro API
│ ├── helius.py # Helius (Wallet, Transactions, DAS)
│ ├── jupiter.py # Jupiter (Token-Preise)
│ ├── coingecko.py # CoinGecko (Preis-Fallback)
│ ├── raydium.py # Raydium (DeFi-Pools)
│ ├── orca.py # Orca (Whirlpools)
│ └── rugcheck.py # RugCheck (Token-Sicherheit)
└── tools/ # MCP-Tool-Definitionen
├── wallet.py # get_wallet_balance, get_transaction_history
├── token.py # get_token_price, get_token_info
├── defi.py # get_defi_yields, compare_yields
└── safety.py # check_token_safetyTech Stack
Python 3.13 + async/await
MCP SDK (FastMCP) — Tool-Registrierung und Transport
httpx — Async HTTP-Client
Pydantic — Settings-Validierung
API-Hinweise
Helius Free Tier: 1M Credits/Monat — reicht für normale Nutzung
CoinGecko Free: 30 Calls/Min, 10.000/Monat — wird nur als Fallback genutzt
Raydium API: Gelegentlich 500 Errors (serverseitig, nicht unser Problem)
RugCheck: Kein API-Key nötig, API ist öffentlich
Scam-Filter: DeFi-Pools mit < $1.000 TVL werden automatisch gefiltert
Lizenz
MIT