@floopfloop/mcp

Сервер протокола Model Context Protocol для API FloopFloop — позволяет Claude Desktop, Cursor, Zed и любому другому хосту LLM с поддержкой MCP создавать, опрашивать и дорабатывать проекты 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 Settings → 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 минут). Большинство сборок завершаются менее чем за две минуты.

• 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

Для проверки рукопожатия stdio без хоста 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

Лицензия

MIT