🚀 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.
✨ 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 |
---|---|---|
PORT | Server-Port | 3000 |
COINGECKO_API_KEY | CoinGecko Pro API-Schlüssel (optional) | - |
CACHE_DURATION | Cache-Dauer in Sekunden | 60 |
LOG_LEVEL | Protokollierungsebene (Fehler, Warnung, Info, Debug) | info |
📚 API-Referenz
RESTful-Endpunkte
Grundlegende Endpunkte
GET /api/ping
- API-Serverstatus prüfen
Preisdaten
GET /api/simple/price
– Preisdaten für angegebene Münzen abrufen- Abfrageparameter:
ids
,vs_currencies
,include_market_cap
,include_24hr_vol
,include_24hr_change
,include_last_updated_at
,precision
- Abfrageparameter:
Münzdaten
GET /api/coins/markets
– Marktdaten für Münzen abrufen- Abfrageparameter:
vs_currency
,ids
,category
,order
,per_page
,page
,sparkline
,price_change_percentage
- Abfrageparameter:
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-Clients - Schemadefinition :
/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
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Ein leistungsstarker und flexibler Node.js Express-Server, der eine umfassende Schnittstelle zur CoinGecko-Kryptowährungsdaten-API bietet. Dieser Server unterstützt sowohl die kostenlose öffentliche API als auch die Pro-API mit automatischem Fallback.
- 🌟 Übersicht
- ✨ Hauptmerkmale
- 🚀 Schnellstart
- 📦 Installation
- ⚙️ Konfiguration
- 📚 API-Referenz
- 🤖 KI-Integration (MCP)
- 💎 Vorteile der Pro-API
- 🔧 Fehlerbehebung
- 🧪 Entwicklung
- 🔄 So funktioniert es
- 📱 Anwendungsfälle
- 📄 Lizenz
- 🙏 Danksagungen
Related Resources
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server built with Express.js that provides cryptographic tools including key pair generation, shared secret derivation, and message encryption/decryption.Last updated -160JavaScript
- -securityAlicense-qualityA Node.js Express server that provides access to CoinGecko's cryptocurrency data through a comprehensive API interface, supporting both free and Pro APIs with automatic fallback functionality.Last updated -1JavaScriptMIT License
- -securityAlicense-qualityProvides cryptocurrency market data using the CoinGecko APILast updated -1PythonMIT License
- -security-license-qualityA server that provides real-time cryptocurrency data through the Model Context Protocol, allowing access to detailed exchange information and current cryptocurrency rates from the CoinCap API.Last updated -1TypeScriptMIT License