@floopfloop/mcp

FloopFloop API用のModel Context Protocolサーバーです。Claude Desktop、Cursor、Zed、その他MCP対応のLLMホストが、ユーザーに代わってFloopFloopプロジェクトの構築、ポーリング、改善を行えるようにします。

公式の @floopfloop/sdk をラップし、その機能の厳選されたサブセットをMCPツールとして公開します。

ツール

Related MCP server: mcp-minecraft

設定

APIキーを取得します：floop keys create mcp-host (floop CLIを使用)、またはダッシュボード → Account → API Keysから取得してください。新しいキーを発行するにはビジネスプランが必要です。

サーバーは環境変数から FLOOP_API_KEY を読み取ります。必要に応じて FLOOP_API_URL を上書きしてステージング環境を指定できます。

Claude Desktop

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

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

Claude Desktopを再起動すると、🔌アイコンの下にツールが表示されます。

Cursor

~/.cursor/mcp.json (または Cursorの設定 → Tools & Integrations → MCP):

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

汎用MCPホスト

MCP stdioトランスポートをサポートするあらゆるホストでサーバーを実行できます：

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

インストール

上記の構成スニペットにある npx -y @floopfloop/mcp を通じてパッケージが自動的に取得されます。固定バージョンをインストールしたい場合は以下を使用してください：

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

使用上の注意

• create_project は即座にビルドを開始します。その後、wait_for_live（ブロック）または project_status（ポーリング）を使用して、いつ公開されたかを確認してください。

• wait_for_live はデフォルトで10分間の上限（timeoutMsにより制限、最大30分）を設定しています。ほとんどのビルドは2分以内に完了します。

• set_secret / remove_secret には destructiveHint: true が設定されています。ホストは実行前にユーザーに確認を求める場合があります。

• list_secrets は名前のみを返し、値は決して返しません。シークレット値は一度書き込まれると取得できないため、再設定してローテーションしてください。

• 失敗した場合、ツールはセッションを終了させるのではなく、MCPの isError コンテンツ結果を返します。これにより、ホストはユーザーにエラーを表示できます。

開発

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

LLMホストなしでstdioハンドシェイクをスモークテストするには：

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

ライセンス

MIT