🚀 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: Crypto Trader MCP Tool

✨ 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

# Option 1: Install and run with npx
npx coingecko-api-server

# Option 2: Clone and install manually
git clone https://github.com/yourusername/coingecko-api-server.git
cd coingecko-api-server
npm install
npm run setup
npm start

📦 Installation

Option 1: Verwenden von npx (empfohlen)

So starten Sie am schnellsten:

npx coingecko-api-server

Dies wird:

1. 📥 Laden Sie den Server herunter und installieren Sie ihn

2. 🧰 Führen Sie einen interaktiven Setup-Assistenten aus

3. 🔑 Fragen Sie nach Ihrem CoinGecko-API-Schlüssel (optional)

4. 🚀 Starten Sie den Server automatisch

Option 2: Manuelle Installation

Für mehr Kontrolle über den Installationsprozess:

# Clone the repository
git clone https://github.com/yourusername/coingecko-api-server.git
cd coingecko-api-server

# Install dependencies
npm install

# Run the setup script
npm run setup

# Start the server
npm start

⚙️ Konfiguration

Der Server wird mithilfe von Umgebungsvariablen in der .env Datei konfiguriert:

📚 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

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

Marktdaten

• GET /api/global – Holen Sie sich globale Kryptowährungsdaten

• GET /api/search/trending – Holen Sie sich trendige Münzen

Beispiele

Bitcoin-Preis in USD abrufen:

curl "http://localhost:3000/api/simple/price?ids=bitcoin&vs_currencies=usd"

Antwort:

{
  "bitcoin": {
    "usd": 45678.12
  }
}

Holen Sie sich die Top 5 Kryptowährungen nach Marktkapitalisierung:

curl "http://localhost:3000/api/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=5&page=1"

🤖 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

1. JSON-RPC-Endpunkt : /rpc – Verarbeitet Methodenaufrufe von KI-Clients

2. Schemadefinition : /mcp/schema – Definiert verfügbare Tools und Parameter

Verfügbare MCP-Methoden

• ping - API-Status prüfen

• getPrice - Preisdaten für angegebene Kryptowährungen abrufen

• getSupportedVsCurrencies – Liste der unterstützten Währungen abrufen

• getCoinMarkets – Holen Sie sich Marktdaten für Münzen

• getGlobal - Holen Sie sich globale Kryptowährungsdaten

• getTrending – 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:

Weitere Einzelheiten zum Einrichten der Pro-API finden Sie unter USING_COINGECKO_PRO.md .

🔧 Fehlerbehebung

🧪 Entwicklung

# Run in development mode with hot reload
npm run dev

# Run tests
npm test

# Build for production
npm run build

🔄 So funktioniert es

Der Server fungiert als Middleware zwischen Ihren Anwendungen und der CoinGecko-API:

1. Anforderungsrouting : Verarbeitet eingehende Anforderungen von RESTful- und JSON-RPC-Clients

2. API-Auswahl : Wählt je nach Konfiguration zwischen kostenlosen und Pro-APIs

3. Rate Limit Management : Implementiert eine intelligente Anforderungsdrosselung

4. Antwortverarbeitung : Formatiert und gibt Daten in einer konsistenten Struktur zurück

5. 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

⬆ Zurück nach oben