🚀 CoinGecko API Server MCP
Nahtloser Zugriff auf Kryptowährungsdaten für KI-Systeme und -Anwendungen
Funktionen • Schnellstart • Installation • Konfiguration • API-Referenz • MCP-Integration • Pro API • Fehlerbehebung • Lizenz
🌟 Übersicht
Der CoinGecko API Server MCP ist eine leistungsstarke, produktionsreife Node.js-Lösung, die nahtlosen Zugriff auf Kryptowährungsmarktdaten über eine elegante RESTful API und eine MCP-Schnittstelle (Marketplace Component Program) bietet. Er verbindet KI-Systeme wie Claude mit Echtzeit-Kryptodaten und bewältigt gleichzeitig alle komplexen API-Ratenbegrenzungen, Fallbacks und Fehlerbehandlungen.
Related MCP server: CoinGecko API Server MCP
✨ Hauptmerkmale
🔄 Dual-API-Unterstützung : Nahtlose Integration mit den kostenlosen und Pro-APIs von CoinGecko
🧠 KI-Integration : Vollständige Implementierung des MCP-Protokolls für KI-Assistenten
🛡️ Intelligenter Fallback : Automatisches Wechseln zwischen APIs, um Ratenbegrenzungen zu verhindern
⚡ Optimierte Leistung : Effiziente Anfrageverarbeitung und Antwort-Caching
📊 Umfassende Daten : Zugriff auf alle wichtigen Kryptowährungsmetriken
🔌 Einfache Schnittstelle : Intuitive RESTful-Endpunkte und JSON-RPC-Methoden
🚦 Robuste Fehlerbehandlung : Klare Fehlermeldungen mit entsprechenden Statuscodes
🧩 Einfache Bereitstellung : Minimale Konfiguration mit geführtem Einrichtungsprozess
📘 Umfangreiche Dokumentation : Klare Gebrauchsanweisungen und Beispiele
🚀 Schnellstart
📦 Installation
Option 1: Verwenden von npx (empfohlen)
So starten Sie am schnellsten:
Dies wird:
📥 Laden Sie den Server herunter und installieren Sie ihn
🧰 Führen Sie einen interaktiven Setup-Assistenten aus
🔑 Fragen Sie nach Ihrem CoinGecko-API-Schlüssel (optional)
🚀 Starten Sie den Server automatisch
Option 2: Manuelle Installation
Für mehr Kontrolle über den Installationsprozess:
⚙️ Konfiguration
Der Server wird mithilfe von Umgebungsvariablen in der .env Datei konfiguriert:
Variable | Beschreibung | Standard |
| Server-Port |
|
| CoinGecko Pro API-Schlüssel (optional) | - |
| Cache-Dauer in Sekunden |
|
| Protokollierungsebene (Fehler, Warnung, Info, Debug) |
|
📚 API-Referenz
RESTful-Endpunkte
Grundlegende Endpunkte
GET /api/ping- API-Serverstatus prüfen
Preisdaten
GET /api/simple/price– Preisdaten für angegebene Münzen abrufenAbfrageparameter:
ids,vs_currencies,include_market_cap,include_24hr_vol,include_24hr_change,include_last_updated_at,precision
Münzdaten
GET /api/coins/markets– Marktdaten für Münzen abrufenAbfrageparameter:
vs_currency,ids,category,order,per_page,page,sparkline,price_change_percentage
Marktdaten
GET /api/global– Holen Sie sich globale KryptowährungsdatenGET /api/search/trending– Holen Sie sich trendige Münzen
Beispiele
Bitcoin-Preis in USD abrufen:
Antwort:
Holen Sie sich die Top 5 Kryptowährungen nach Marktkapitalisierung:
🤖 KI-Integration (MCP)
Dieser Server implementiert das Marketplace Component Program (MCP)-Protokoll, wodurch KI-Systeme wie Claude auf Kryptowährungsdaten zugreifen können.
MCP-Integrationspunkte
JSON-RPC-Endpunkt :
/rpc– Verarbeitet Methodenaufrufe von KI-ClientsSchemadefinition :
/mcp/schema– Definiert verfügbare Tools und Parameter
Verfügbare MCP-Methoden
ping- API-Status prüfengetPrice- Preisdaten für angegebene Kryptowährungen abrufengetSupportedVsCurrencies– Liste der unterstützten Währungen abrufengetCoinMarkets– Holen Sie sich Marktdaten für MünzengetGlobal- Holen Sie sich globale KryptowährungsdatengetTrending– Holen Sie sich trendige Münzen
Ausführliche Integrationsanweisungen finden Sie unter MCP_INTEGRATION.md .
💎 Vorteile der Pro-API
Dieser Server unterstützt sowohl die CoinGecko Pro API als auch die kostenlose API:
Besonderheit | Kostenlose API | Pro API |
Ratenbegrenzung | ~30 Anrufe/Minute | ~500 Anrufe/Minute |
API-Drosselung | Ja | NEIN |
Unterstützung | Gemeinschaft | Priorität |
Datenaktualität | 10-30 Minuten | 1-2 Minuten |
Preis | Frei | Abonnement |
Weitere Einzelheiten zum Einrichten der Pro-API finden Sie unter USING_COINGECKO_PRO.md .
🔧 Fehlerbehebung
Ausgabe | Lösung |
Ratenbegrenzungsfehler | Erwägen Sie ein Upgrade auf die Pro-API oder passen Sie Ihre Anfragehäufigkeit an |
Verbindung abgelehnt | Stellen Sie sicher, dass der Server auf dem angegebenen Port läuft |
Authentifizierungsfehler | Überprüfen Sie Ihren API-Schlüssel in der .env-Datei |
Fehlende Daten | Überprüfen Sie die Parameter in Ihrer Anfrage |
🧪 Entwicklung
🔄 So funktioniert es
Der Server fungiert als Middleware zwischen Ihren Anwendungen und der CoinGecko-API:
Anforderungsrouting : Verarbeitet eingehende Anforderungen von RESTful- und JSON-RPC-Clients
API-Auswahl : Wählt je nach Konfiguration zwischen kostenlosen und Pro-APIs
Rate Limit Management : Implementiert eine intelligente Anforderungsdrosselung
Antwortverarbeitung : Formatiert und gibt Daten in einer konsistenten Struktur zurück
Fehlerbehandlung : Bietet detaillierte Fehlerinformationen zur Fehlerbehebung
📱 Anwendungsfälle
Finanzberater mit KI-Unterstützung : Ermöglichen Sie KI-Systemen den Zugriff auf Kryptodaten in Echtzeit
Investment-Dashboards : Erstellen Sie Kryptowährungs-Dashboards mit zuverlässigem Datenzugriff
Portfolio-Tracker : Erstellen Sie Anwendungen zur Überwachung von Krypto-Beständen
Marktanalyse-Tools : Entwickeln Sie Tools für die technische und fundamentale Analyse
Trading Bots : Automatisierte Handelssysteme mit Marktdaten versorgen
📄 Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .
🙏 Danksagungen
CoinGecko für die umfassende Kryptowährungsdaten-API
Anthropisch für Claude AI und das MCP-Programm
Die Open-Source-Community für ihre unschätzbaren Beiträge