CLI-Nutzung

Installation

npm install -g github:FlowMCP/flowmcp-cli

CLI-Workflow

Die CLI folgt einem Drei-Schritte-Muster: Tools entdecken, aktivieren, dann aufrufen.

Kernbefehle

Befehl	Beschreibung
`flowmcp search <query>`	Tools suchen (max. 10 Ergebnisse)
`flowmcp add <tool-name>`	Tool aktivieren + Parameter anzeigen
`flowmcp call <tool-name> '{json}'`	Tool mit JSON-Parametern aufrufen
`flowmcp remove <tool-name>`	Tool deaktivieren
`flowmcp list`	Aktive Tools anzeigen
`flowmcp status`	Health-Check

Suchen, Hinzufuegen, Aufrufen

Tools suchen

Tools per Stichwort finden. Ergebnisse enthalten Name, Beschreibung und den Befehl zum Hinzufuegen.

flowmcp search ethereum
# Zeigt bis zu 10 passende Tools mit Name + Beschreibung

flowmcp search "token price"
# Suche verfeinern bei zu vielen Ergebnissen

Tool hinzufuegen

Ein Tool fuer das Projekt aktivieren. Die Antwort zeigt die Parameter des Tools mit Typen und Anforderungen.
Terminal-Fenster
```
flowmcp add get_contract_abi_etherscan
# Antwort zeigt: Name, Beschreibung, Parameter mit Typen
```
Das Parameter-Schema wird auch lokal in .flowmcp/tools/ gespeichert.
Tool aufrufen

Das Tool mit JSON-Parametern ausfuehren. Verwende die Parameter-Informationen aus der add-Antwort.
Terminal-Fenster
```
flowmcp call get_contract_abi_etherscan '{"address": "0xdAC17F958D2ee523a2206206994597C13D831ec7"}'
```

Agent-Modus vs Dev-Modus

Die CLI hat zwei Betriebsmodi, die steuern, welche Befehle verfuegbar sind:

Modus	Befehle	Anwendungsfall
Agent	search, add, call, remove, list, status	Taeglicher KI-Agent-Einsatz
Dev	+ validate, test, migrate	Schema-Entwicklung

flowmcp mode dev    # In den Dev-Modus wechseln
flowmcp mode agent  # Zurueck zum Agent-Modus

Dev-Modus-Befehle

Der Dev-Modus schaltet zusaetzliche Befehle fuer Schema-Autoren frei:

flowmcp validate <path>           # Schema-Struktur validieren
flowmcp test single <path>        # Live-API-Test
flowmcp validate-agent <path>     # Agent-Manifest validieren

Lokale Projektkonfiguration

Wenn du Tools hinzufuegst, wird ein .flowmcp/-Verzeichnis in deinem Projekt erstellt:

.flowmcp/
├── config.json              # Aktive Tools + Modus
└── tools/                   # Parameter-Schemas (automatisch generiert)
    └── get_contract_abi_etherscan.json

Jede Datei in tools/ enthaelt den Tool-Namen, die Beschreibung und die erwarteten Eingabeparameter:

{
    "name": "get_contract_abi_etherscan",
    "description": "Returns the Contract ABI of a verified smart contract",
    "parameters": {
        "address": { "type": "string", "required": true }
    }
}

API-Schluessel

Manche Tools benoetigen API-Schluessel, die in ~/.flowmcp/.env gespeichert werden. Wenn ein call wegen fehlender Schluessel fehlschlaegt, fuege den benoetigten Schluessel zur globalen Konfiguration hinzu:

echo "ETHERSCAN_API_KEY=your_key_here" >> ~/.flowmcp/.env

API-Schluessel niemals in die Versionskontrolle committen. Die .env-Datei in ~/.flowmcp/ ist dein globaler Schluessel-Speicher und sollte nur auf deinem Rechner bleiben.