SDK dan MCP

FloopFloop SDKs & MCP

FloopFloop menyediakan delapan SDK bahasa resmi ditambah sebuah server MCP untuk agen AI. Setiap antarmuka menargetkan backend /api/v1/*yang sama — sehingga proyek yang dibuat melalui Node SDK adalah proyek yang sama yang akan dilihat oleh LLM yang berjalan melalui MCP, byte-for-byte.

Pilih antarmuka yang tepat untuk stack Anda:

• Membangun aplikasi atau backend? Gunakan SDK untuk bahasa Anda.
• Membangun agen AI / chatbot? Gunakan server @floopfloop/mcp dengan Claude Desktop, Cursor, Zed, Copilot CLI, atau host yang mendukung MCP.
• Mengoperasikan dari terminal? Gunakan FloopFloop CLI.

Server MCP — untuk agen AI

@floopfloop/mcp— Server Model Context Protocol. Membungkus API FloopFloop sebagai 23 alat yang dapat dipanggil oleh host LLM yang mendukung MCP.

Alat mencakup siklus hidup proyek penuh: create_project, refine_project, upload_from_path(lampiran), cancel_project, reactivate_project, wait_for_live, list_secrets / set_secret / remove_secret, list_library_projects / clone_library_project, current_subscription, usage_summary, ditambah pemeriksaan subdomain dan manajemen kunci API. Setiap alat bersifat hanya-baca atau ditandai destructiveHint sehingga host dapat meminta konfirmasi pengguna sebelum mengubah status.

Cuplikan konfigurasi Claude Desktop

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

Tambahkan ke ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) atau %APPDATA%\Claude\claude_desktop_config.json(Windows), mulai ulang Claude Desktop, dan minta “buatkan saya situs FloopFloop untuk <X>”.

Pasangkan dengan floop-skills untuk panduan alur kerja

MCP mengekspos kemampuan; floop-skills menyediakan skill markdown gaya Anthropic yang menjelaskan alur kerja — kapan memanggil alat mana, dalam urutan apa, dengan argumen apa. Instal keduanya untuk pengalaman agen terbaik:

mkdir -p ~/.claude/skills
git clone https://github.com/FloopFloopAI/floop-skills.git /tmp/floop-skills
cp -r /tmp/floop-skills/skills/* ~/.claude/skills/

Tautan: npm · GitHub · floop-skills

SDK Bahasa

Antarmuka yang sama di semua delapan: client.projects.create(), refine, waitForLive / streaming, secrets, uploads, library, apiKeys, subscriptions.current, usage.summary, subdomains, user.me. Setiap SDK dikirimkan sesuai idiom asli bahasanya (sync + async pada Python, Flow pada Kotlin, AsyncThrowingStreampada Swift, dll.) namun kontrak wire — kode kesalahan, amplop respons, semantik status terminal — identik.

Node / TypeScript — @floopfloop/sdk

Node 20+. fetch asli, tipe TypeScript penuh,AsyncIterator untuk streaming. SDK kanonik; server MCP langsung membungkus yang ini.

npm install @floopfloop/sdk

import { FloopClient } from "@floopfloop/sdk";

const floop = new FloopClient({ apiKey: process.env.FLOOP_API_KEY! });
const { project } = await floop.projects.create({
  prompt: "a cat-cafe blog with three sample posts",
});
const live = await floop.projects.waitForLive(project.id);
console.log(live.url);

Tautan: npm · GitHub · cookbook

Python — floopfloop

Python 3.10+. FloopClient sinkron pada httpx.Client ditambah AsyncFloopClient asinkron pada httpx.AsyncClient — sembilan aksessor sumber daya yang sama, async for pada projects.stream.

pip install floopfloop

from floopfloop import FloopClient

floop = FloopClient(api_key=os.environ["FLOOP_API_KEY"])
created = floop.projects.create(prompt="a cat cafe landing page")
live = floop.projects.wait_for_live(created["project"]["id"])
print(live["url"])

Tautan: PyPI · GitHub · cookbook

Go — github.com/FloopFloopAI/floop-go-sdk

Go 1.22+. Argumen pertama context.Context yang idiomatis, *Error dengan bidang kode bertipe, streaming ramah-channel.

go get github.com/FloopFloopAI/floop-go-sdk@latest

client := floop.NewClient(os.Getenv("FLOOP_API_KEY"))
res, err := client.Projects.Create(ctx, floop.CreateProjectInput{
    Prompt: "a cat cafe landing page",
})
if err != nil { log.Fatal(err) }
live, err := client.Projects.WaitForLive(ctx, res.Project.ID, nil)
fmt.Println(live.URL)

Tautan: pkg.go.dev · GitHub · cookbook

Rust — floopfloop

Rust 2021 / 1.75+. Asinkron berbasis tokio, pola builder pada klien, enum FloopErrorCode bertipe, Result<T, FloopError> pada setiap metode.

# Cargo.toml
floopfloop = "0.1.0-alpha.4"

use floopfloop::{Client, CreateProjectInput};

let client = Client::new(std::env::var("FLOOP_API_KEY")?)?;
let res = client.projects().create(CreateProjectInput {
    prompt: "a cat cafe landing page".into(),
    ..Default::default()
}).await?;
let live = client.projects().wait_for_live(&res.project.id, None).await?;
println!("{}", live.url.unwrap_or_default());

Tautan: crates.io · docs.rs · GitHub · cookbook

Ruby — floopfloop

Ruby 3.0+. Transport Net::HTTP, respons berbasis hash (tanpa wrapper bertipe yang opinionated), pengiriman blok untuk streaming.

gem install floopfloop

require "floopfloop"

client = FloopFloop::Client.new(api_key: ENV.fetch("FLOOP_API_KEY"))
res = client.projects.create(prompt: "a cat cafe landing page")
live = client.projects.wait_for_live(res["project"]["id"])
puts live["url"]

Tautan: RubyGems · GitHub · cookbook

PHP — floopfloop/sdk

PHP 8.1+. Transport stdlib murni (tidak perlu ext-curl), konstruktor ramah named-argument, kelas pengecualian FloopFloop\Error dengan kode bertipe.

composer require floopfloop/sdk

$client = new FloopFloop\Client(apiKey: getenv('FLOOP_API_KEY'));
$res = $client->projects()->create(prompt: 'a cat cafe landing page');
$live = $client->projects()->waitForLive($res['project']['id']);
echo $live['url'];

Tautan: Packagist · GitHub · cookbook

Swift — FloopFloop (SPM)

Swift 5.9+. async/await di seluruh kode, tipe Codable, AsyncThrowingStream untuk streaming. iOS 17+ / macOS 14+ / tvOS 17+ / watchOS 10+ / visionOS 1+. Sisi server / desktop saat ini; distribusi aplikasi mobile memerlukan alur autentikasi berbeda di backend (peta jalan).

// Package.swift
.package(url: "https://github.com/FloopFloopAI/floop-swift-sdk.git", from: "0.1.0-alpha.2")

import FloopFloop

let client = FloopFloop(apiKey: ProcessInfo.processInfo.environment["FLOOP_API_KEY"]!)
let res = try await client.projects.create(.init(prompt: "a cat cafe landing page"))
let live = try await client.projects.waitForLive(res.project.id)
print(live.url ?? "")

Tautan: Tag SPM · GitHub · cookbook

Kotlin / JVM — floop-kotlin-sdk

Kotlin 2.0+ / JVM 11+. OkHttp + kotlinx-serialization + kotlinx-coroutines. Fungsi suspend di seluruh kode; streaming melalui Flow<StatusEvent> yang dingin. Distribusi JitPack (Maven Central direncanakan).

// build.gradle.kts
repositories {
    maven("https://jitpack.io")
}
dependencies {
    implementation("com.github.FloopFloopAI:floop-kotlin-sdk:0.1.0-alpha.3")
}

import com.floopfloop.sdk.FloopFloop
import com.floopfloop.sdk.resources.CreateProjectInput

val client = FloopFloop(apiKey = System.getenv("FLOOP_API_KEY"))
val res = client.projects.create(CreateProjectInput(prompt = "a cat cafe landing page"))
val live = client.projects.waitForLive(res.project.id)
println(live.url)

Tautan: JitPack · GitHub · cookbook

Kunci API

Setiap SDK menggunakan kunci API programatik flp_… untuk autentikasi, yang berbeda dari token perangkat yang digunakan CLI untuk login interaktif. Penerbitan kunci API memerlukan paket Business. Buat kunci dari Akun → Kunci API, simpan di manajer rahasia / lingkungan Anda, dan teruskan ke konstruktor SDK.

Lihat Autentikasi API untuk model kunci lengkap (cakupan, batas kecepatan, pola rotasi).

Sumber & rilis

Semua delapan repo SDK ditambah MCP dan skills adalah open-source di bawah lisensi MIT di github.com/FloopFloopAI. Setiap rilis dikirim ke registry standar bahasanya masing-masing saat push tag (npm, PyPI, crates.io, RubyGems, Packagist, Go modules, JitPack, tag SPM). CHANGELOG per SDK di setiap repo; koordinasi rilis lintas SDK dilacak di monorepo.