@floopfloop/mcp

Servidor del Protocolo de Contexto de Modelo (MCP) para la API de FloopFloop: permite a Claude Desktop, Cursor, Zed y cualquier otro host de LLM compatible con MCP crear, consultar y refinar proyectos de FloopFloop en nombre del usuario.

Envuelve el @floopfloop/sdk oficial y expone un subconjunto seleccionado de su superficie como herramientas MCP.

Herramientas

Related MCP server: mcp-minecraft

Configuración

Obtén una clave de API: floop keys create mcp-host (a través de la CLI de floop) o en el panel de control → Cuenta → Claves de API. Se requiere un plan Business para generar nuevas claves.

El servidor lee FLOOP_API_KEY del entorno. Opcionalmente, puedes sobrescribir FLOOP_API_URL para apuntar a staging.

Claude Desktop

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

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

Reinicia Claude Desktop; las herramientas aparecerán bajo el icono 🔌.

Cursor

~/.cursor/mcp.json (o Configuración de Cursor → Herramientas e Integraciones → MCP):

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

Host MCP genérico

Cualquier host que utilice el transporte stdio de MCP puede ejecutar el servidor:

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

Instalación

El paquete se descarga automáticamente mediante npx -y @floopfloop/mcp en los fragmentos de configuración anteriores. Si prefieres una instalación fija:

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

Notas de uso

• create_project inicia una compilación de inmediato. Haz un seguimiento con wait_for_live (bloquea) o project_status (consulta) para saber cuándo está activo.

• wait_for_live tiene un límite predeterminado de 10 minutos (limitado por timeoutMs, con un máximo de 30 min). La mayoría de las compilaciones terminan en menos de dos minutos.

• set_secret / remove_secret están marcados con destructiveHint: true: los hosts pueden pedir al usuario que confirme antes de ejecutarlos.

• list_secrets solo devuelve nombres, nunca valores. Los valores secretos no se pueden recuperar una vez escritos; rótalos volviéndolos a establecer.

• En caso de error, las herramientas devuelven un resultado de contenido isError de MCP en lugar de cerrar la sesión, por lo que el host muestra el error al usuario.

Desarrollo

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

Para realizar una prueba de humo del handshake de stdio sin un host LLM:

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

Licencia

MIT