Alchemy MCP-Server

Ein Model Context Protocol (MCP) Server, der es KI-Agenten ermöglicht, strukturiert mit den Blockchain-APIs von Alchemy zu interagieren. Dies erlaubt Agenten, Blockchain-Daten direkt abzufragen, ohne Code schreiben zu müssen.

Remote MCP-Server (Empfohlen)

Der schnellste Weg für den Einstieg ist die Verbindung zum gehosteten Remote-Server unter https://mcp.alchemy.com/mcp. Die Authentifizierung erfolgt über OAuth – melden Sie sich einfach bei Aufforderung mit Ihrem Alchemy-Konto an. Es sind kein API-Schlüssel und keine lokale Installation erforderlich.

Vollständige Dokumentation: alchemy.com/docs/alchemy-mcp-server

Hinweis: Der gehostete Server unter mcp.alchemy.com und dieses Open-Source-Repository werden separat gepflegt und sind möglicherweise nicht synchron.

{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

{
  "servers": {
    "alchemy": {
      "type": "http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

Für jeden anderen MCP-kompatiblen Client verweisen Sie auf https://mcp.alchemy.com/mcp unter Verwendung des Streamable HTTP-Transports.

Related MCP server: Substrate MCP Server

Lokaler STDIO-Server

Dieser MCP-Server bildet eine Brücke zwischen KI-Agenten und den Blockchain-APIs von Alchemy und ermöglicht es Agenten:

• Token-Preise und Preisverläufe abzufragen (einschließlich flexibler Zeitrahmenabfragen)

• NFT-Besitzinformationen und Vertragsdaten abzurufen

• Transaktionsverläufe über mehrere Netzwerke hinweg einzusehen

• Token-Guthaben über mehrere Blockchain-Netzwerke hinweg zu prüfen

• Detaillierte Asset-Transfers mit Filtern abzurufen

• Transaktionen über Smart-Contract-Konten zu senden (erfordert einen konfigurierten Wallet-Agent-Server)

• Token-Swaps über DEX-Protokolle auszuführen (erfordert einen konfigurierten Wallet-Agent-Server)

• Und mehr!

Schnelleinrichtung

Um den MCP-Server schnell einzurichten, verwenden Sie die folgende Konfiguration in Ihrer MCP-Konfigurationsdatei (normalerweise in den Einstellungen von Claude Desktop oder Cursor):

{
  "mcpServers": {
    "alchemy": {
      "command": "npx",
      "args": ["-y", "@alchemy/mcp-server"],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Diese Konfiguration ermöglicht es Ihnen, den Server zu verwenden, ohne das Repository manuell klonen zu müssen.

Umgebungsvariablen

Der MCP-Server benötigt die folgende Umgebungsvariable:

• ALCHEMY_API_KEY - Ihr Alchemy API-Schlüssel (erforderlich für alle Blockchain-Datenabfragen)

Für Transaktions- und Swap-Funktionalität müssen Sie zusätzlich Folgendes konfigurieren:

• AGENT_WALLET_SERVER - URL eines konfigurierten Wallet-Agent-Servers, der Smart-Contract-Konto-Operationen abwickelt

⚠️ Wichtig: Die Methoden sendTransaction und swap funktionieren nicht ohne einen ordnungsgemäß konfigurierten Wallet-Agent-Server. Diese Methoden erfordern eine externe Wallet-Infrastruktur, um das Signieren und Senden von Transaktionen zu übernehmen.

Verfügbare Methoden

Sie können Ihren KI-Agenten anweisen, die folgenden Methoden zu verwenden:

Token-Preis-Methoden

1. fetchTokenPriceBySymbol

   • Ruft aktuelle Preisdaten für Token nach Symbol ab

   • Beispiel: "Was ist der aktuelle Preis von ETH und BTC?"

2. fetchTokenPriceByAddress

   • Ruft aktuelle Preisdaten für Token nach Vertragsadresse ab

   • Beispiel: "Was ist der Preis des Tokens an der Adresse 0x1234...5678 im Ethereum-Mainnet?"

3. fetchTokenPriceHistoryBySymbol

   • Ruft historische Preisdaten für Token mit bestimmten Datumsbereichen ab

   • Beispiel: "Zeige mir den BTC-Preisverlauf vom 1. Januar bis zum 1. Februar 2023 in täglichen Intervallen"

4. fetchTokenPriceHistoryByTimeFrame

   • Ruft historische Preisdaten unter Verwendung flexibler Zeitrahmen oder natürlicher Sprache ab

   • Beispiel: "Zeige mir den ETH-Preis für die letzte Woche" oder "Hole den BTC-Preis für die letzten 30 Tage"

Multichain-Token-Methoden

5. fetchTokensOwnedByMultichainAddresses

   • Ruft Token-Guthaben für Adressen über mehrere Netzwerke hinweg ab

   • Beispiel: "Welche Token hält 0xabc...123 auf Ethereum und Base?"

Transaktionsverlauf-Methoden

6. fetchAddressTransactionHistory

   • Ruft den Transaktionsverlauf für Adressen über mehrere Netzwerke hinweg ab

   • Beispiel: "Zeige aktuelle Transaktionen für Wallet 0xdef...456 auf Ethereum"

7. fetchTransfers

   • Ruft detaillierte Asset-Transferdaten mit erweiterten Filteroptionen ab

   • Beispiel: "Zeige mir alle ERC-20-Transfers an oder von 0xghi...789"

NFT-Methoden

8. fetchNftsOwnedByMultichainAddresses

   • Ruft alle NFTs ab, die von Adressen gehalten werden, inklusive Spam-Filterung

   • Beispiel: "Welche NFTs besitzt 0xjkl...012?"

9. fetchNftContractDataByMultichainAddress

   • Ruft NFT-Vertragsdaten für Adressen ab

   • Beispiel: "Von welchen NFT-Kollektionen hat 0xmno...345 Token?"

Transaktionsmethoden

10. sendTransaction

    • Sendet Transaktionen über Smart-Contract-Konten

    • ⚠️ Wichtig: Erfordert einen konfigurierten Wallet-Agent-Server mit der Umgebungsvariable AGENT_WALLET_SERVER

    • Beispiel: "Sende 0.1 ETH an 0xpqr...678"

Swap-Methoden

11. swap

    • Führt Token-Swaps über DEX-Protokolle (Uniswap) aus

    • ⚠️ Wichtig: Erfordert einen konfigurierten Wallet-Agent-Server mit der Umgebungsvariable AGENT_WALLET_SERVER

    • Beispiel: "Tausche 100 USDC gegen ETH"

Lokale Entwicklung und Open-Source-Beiträge

Installation

1. Repository klonen

git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp

2. Abhängigkeiten installieren

pnpm install

Entwicklung

pnpm watch

Build für die Produktion

pnpm build

Verwendung des MCP-Inspectors zum Debuggen

Der MCP-Inspector hilft Ihnen beim Debuggen Ihres MCP-Servers, indem er eine visuelle Schnittstelle zum Testen Ihrer Methoden bereitstellt:

pnpm inspector

Dies startet den MCP-Inspector, auf den Sie in Ihrem Browser zugreifen können. Er ermöglicht Ihnen:

• Alle verfügbaren Methoden zu sehen

• Methoden mit verschiedenen Parametern zu testen

• Die Antwortdaten einzusehen

• Probleme mit Ihrem MCP-Server zu debuggen

Mitwirken

Pull Requests sind willkommen. Bei größeren Änderungen eröffnen Sie bitte zuerst ein Issue, um zu besprechen, was Sie ändern möchten.

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software frei verwenden, modifizieren und verbreiten dürfen, vorbehaltlich der Bedingungen der MIT-Lizenz.

Beispiel-Prompts

Hier sind einige Beispiel-Prompts, die Sie mit Ihrem KI-Agenten verwenden können:

What's the current price of Bitcoin and Ethereum?

Show me the NFTs owned by the wallet 0x1234...5678 on Ethereum.

What tokens does wallet 0xabcd...6789 hold across Ethereum and Base?

Get me the transaction history for 0x9876...5432.

Show me the price history of Ethereum from January 1st to today with daily intervals.

Get me Bitcoin price data for the last week with hourly intervals.

Show me ETH price performance for the past month.

What ERC-20 transfers happened to address 0x1234...5678 in the last 100 blocks?

API-Referenz

Weitere Informationen zu den APIs von Alchemy finden Sie unter:

• Alchemy API-Dokumentation