@floopfloop/mcp

FloopFloop API를 위한 Model Context Protocol 서버입니다. Claude Desktop, Cursor, Zed 및 기타 MCP 지원 LLM 호스트가 사용자를 대신하여 FloopFloop 프로젝트를 빌드, 폴링 및 개선할 수 있도록 합니다.

공식 @floopfloop/sdk를 래핑하고 해당 기능의 일부를 MCP 도구로 노출합니다.

도구

Related MCP server: mcp-minecraft

구성

API 키를 받으려면 floop CLI를 통해 floop keys create mcp-host를 실행하거나 대시보드 → 계정 → API 키로 이동하세요. 새 키를 생성하려면 비즈니스 플랜이 필요합니다.

서버는 환경에서 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 설정 → 도구 및 통합 → 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분 제한(최대 30분까지 timeoutMs로 제한)을 가집니다. 대부분의 빌드는 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