Schema-Bibliothek

Die FlowMCP Schema-Bibliothek ist eine kuratierte Sammlung von 187+ produktionsreifen Schemas fuer DeFi, Blockchain-Analytik, Utilities und mehr. Jedes Schema folgt der FlowMCP v2.0.0-Spezifikation und ist validiert, getestet und einsatzbereit.

Schemas durchsuchen: flowmcp.github.io/flowmcp-schemas

Verwendung

Verfuegbare Schemas durchsuchen

Besuche flowmcp.github.io/flowmcp-schemas um alle verfuegbaren Schemas zu erkunden, oder nutze die CLI:
Terminal-Fenster
```
flowmcp search etherscan
flowmcp search "gas price"
flowmcp search defi
```
Schemas importieren

Importiere die gesamte Schema-Bibliothek in deine FlowMCP CLI:
Terminal-Fenster
```
flowmcp import https://github.com/FlowMCP/flowmcp-schemas
```
Falls du bereits flowmcp init ausgefuehrt hast, sind die Schemas moeglicherweise bereits importiert.

Tools zum Projekt hinzufuegen

Aktiviere bestimmte Tools:

flowmcp add coingecko_simplePrice
flowmcp add etherscan_getGasOracle

Oder erstelle eine Gruppe mit mehreren Tools:

flowmcp group append defi --tools "flowmcp-schemas/coingecko/simplePrice.mjs,flowmcp-schemas/defillama/protocols.mjs"
flowmcp group set-default defi

Tools aufrufen

Fuehre Tools direkt aus:
Terminal-Fenster
```
flowmcp call coingecko_simplePrice '{"ids":"bitcoin","vs_currencies":"usd"}'
```
Oder starte einen MCP-Server, um sie AI-Clients bereitzustellen:
Terminal-Fenster
```
flowmcp run
```

Schemas programmatisch verwenden

Importiere Schemas direkt in deinem Node.js-Code:

import { FlowMCP } from 'flowmcp-core'

// Load a schema from file
const { status, main, handlerMap } = await FlowMCP.loadSchema( {
    filePath: './node_modules/flowmcp-schemas/coingecko/simplePrice.mjs'
} )

// Execute a tool call
const result = await FlowMCP.fetch( {
    main,
    handlerMap,
    userParams: { ids: 'bitcoin', vs_currencies: 'usd' },
    serverParams: {},
    routeName: 'simplePrice'
} )

console.log( result.dataAsString )

API Keys

Einige Schemas erfordern API Keys. Diese werden im requiredServerParams-Feld des Schemas deklariert:

Anbieter	Erforderlicher Key	Kostenloses Kontingent
Etherscan	`ETHERSCAN_API_KEY`	Ja
CoinGecko	`COINGECKO_API_KEY`	Ja (limitiert)
Moralis	`MORALIS_API_KEY`	Ja
Dune Analytics	`DUNE_API_KEY`	Ja (limitiert)
Helius	`HELIUS_API_KEY`	Ja

Speichere API Keys in ~/.flowmcp/.env:

ETHERSCAN_API_KEY=your_key_here
COINGECKO_API_KEY=your_key_here
MORALIS_API_KEY=your_key_here

Shared Lists

Viele Schemas referenzieren Shared Lists zur anbieteruebergreifenden Wertnormalisierung. Die haeufigste Shared List ist evmChains, die ein einheitliches Chain-Register bereitstellt:

// Schema references the shared list
sharedLists: [
    { ref: 'evmChains', version: '1.0.0', filter: { key: 'etherscanAlias', exists: true } }
]

// Parameter uses the list for enum generation
z: { primitive: 'enum({{evmChains:etherscanAlias}})', options: [] }

Das bedeutet, ein einzelnes Schema kann mehrere EVM-Chains ueber denselben Parameter unterstuetzen, wobei die Chain-Liste zentral gepflegt wird.

Beitragen

Neue Schemas sind willkommen. Folge diesen Schritten:

Repository forken

Forke FlowMCP/flowmcp-schemas auf GitHub.
Schema erstellen

Schreibe dein Schema gemaess dem Schema Creation Guide. Platziere es im entsprechenden Anbieter-Verzeichnis.
Validieren

Fuehre die Validierung gegen die FlowMCP-Spezifikation aus:
Terminal-Fenster
```
flowmcp validate ./your-schema.mjs
```
Testen

Teste mit Live-API-Aufrufen:
Terminal-Fenster
```
flowmcp test single ./your-schema.mjs
```
Pull Request einreichen

Eroeffne einen PR mit deinem Schema. Fuege die Validierungs- und Testergebnisse in die PR-Beschreibung ein.

Qualitaetsstandards

Alle Schemas in der Bibliothek muessen diese Anforderungen erfuellen:

v2.0.0-Format mit allen Pflichtfeldern (namespace, name, description, version, routes)
Output-Schemas fuer alle Routes (output.schema mit JSON Schema zur Beschreibung der Antwort)
Dokumentations-Links im docs-Feld
Tags fuer Auffindbarkeit
Bestandene Validierung via flowmcp validate
Bestandene Tests via flowmcp test single (mindestens eine Route muss Daten zurueckgeben)