@floopfloop/mcp

FloopFloop API 的模型上下文协议 (MCP) 服务器 — 允许 Claude Desktop、Cursor、Zed 以及任何其他支持 MCP 的 LLM 主机代表用户构建、轮询和优化 FloopFloop 项目。

封装了官方的 @floopfloop/sdk，并将其功能的一个精选子集作为 MCP 工具公开。

工具

Related MCP server: mcp-minecraft

配置

获取 API 密钥：使用 floop keys create mcp-host（通过 floop CLI）或在仪表板 → 账户 → 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 分钟（受 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

要在没有 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