@floopfloop/mcp

Model Context Protocol-Server für die FloopFloop-API – ermöglicht es Claude Desktop, Cursor, Zed und jedem anderen MCP-fähigen LLM-Host, FloopFloop-Projekte im Auftrag des Benutzers zu erstellen, abzufragen und zu verfeinern.

Umschließt das offizielle @floopfloop/sdk und stellt eine kuratierte Teilmenge seiner Funktionen als MCP-Tools bereit.

Tools

Related MCP server: mcp-minecraft

Konfiguration

Holen Sie sich einen API-Schlüssel: floop keys create mcp-host (über die floop CLI) oder über das Dashboard → Account → API Keys. Für das Erstellen neuer Schlüssel ist ein Business-Plan erforderlich.

Der Server liest FLOOP_API_KEY aus der Umgebung. Optional kann FLOOP_API_URL überschrieben werden, um auf Staging zu verweisen.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %AppData%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "floopfloop": {
      "command": "npx",
      "args": ["-y", "@floopfloop/mcp"],
      "env": { "FLOOP_API_KEY": "flp_..." }
    }
  }
}

Starten Sie Claude Desktop neu; die Tools erscheinen unter dem 🔌-Symbol.

Cursor

~/.cursor/mcp.json (oder Cursor Settings → Tools & Integrations → MCP):

{
  "mcpServers": {
    "floopfloop": {
      "command": "npx",
      "args": ["-y", "@floopfloop/mcp"],
      "env": { "FLOOP_API_KEY": "flp_..." }
    }
  }
}

Generischer MCP-Host

Jeder Host, der das MCP-Stdio-Transportprotokoll unterstützt, kann den Server ausführen:

FLOOP_API_KEY=flp_... npx -y @floopfloop/mcp

Installation

Das Paket wird in den obigen Konfigurationsschnipseln automatisch über npx -y @floopfloop/mcp geladen. Wenn Sie eine feste Version bevorzugen:

npm install -g @floopfloop/mcp
which floop-mcp

Nutzungshinweise

• create_project startet sofort einen Build. Verwenden Sie anschließend wait_for_live (blockierend) oder project_status (Abfrage), um zu erfahren, wann es bereit ist.

• wait_for_live hat standardmäßig ein Limit von 10 Minuten (begrenzt durch timeoutMs, maximal 30 Minuten). Die meisten Builds sind in unter zwei Minuten fertig.

• set_secret / remove_secret sind mit destructiveHint: true markiert – Hosts fordern den Benutzer möglicherweise vor der Ausführung zur Bestätigung auf.

• list_secrets gibt nur Namen zurück, niemals Werte. Geheimniswerte können nach dem Schreiben nicht mehr abgerufen werden; rotieren Sie diese durch erneutes Setzen.

• Bei Fehlern geben Tools ein MCP isError-Inhaltsergebnis zurück, anstatt die Sitzung zu beenden, sodass der Host den Fehler dem Benutzer anzeigen kann.

Entwicklung

git clone https://github.com/FloopFloopAI/floop-mcp.git
cd floop-mcp
npm install
npm run typecheck
npm run build

FLOOP_API_KEY=flp_... node dist/index.js

Um den Stdio-Handshake ohne LLM-Host zu testen:

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | FLOOP_API_KEY=flp_dummy node dist/index.js 2>/dev/null

Lizenz

MIT