bldbl-mcp 是 Buildable 的官方 MCP（Model Context Protocol）客户端。Buildable（bldbl.dev）是一个 AI 驱动的开发平台，官方描述其目标是“让任何项目变得可构建”。通过本包，AI 助手（Claude、GPT 等）可以依照 MCP 标准直接与 Buildable 项目交互，获取项目上下文、管理任务、跟踪进度，并与人类开发者沟通。
用途
该工具面向希望让 AI 助手参与实际软件项目流程的开发团队和个人。AI 助手可以读取项目计划与任务详情，自主开始任务、上报进度、完成任务，并在遇到阻塞或需要决策时创建讨论向人类提问，从而在 Buildable 平台上实现人机协作开发。
主要能力
根据仓库资料，配置完成后 AI 助手可使用以下工具： get_project_context：了解整个项目结构（含计划、任务与近期活动）； get_next_task：依据依赖与优先级找到下一个要做的任务； start_task：开始处理某个具体任务，可选填写方法与时间估算； update_progress：上报当前任务的详细进度； complete_task：将任务标记为完成并附详细说明； create_discussion：在需要人类输入时创建讨论/问题； health_check：检查与 Buildable 的连接是否正常。 此外，客户端类 BuildPlannerMCPClient 支持配置 apiUrl、apiKey、projectId、aiAssistantId、timeout、retryAttempts、retryDelay 等参数，并内置错误处理与重试机制。
使用方式
安装：可通过 Smithery 自动安装 @bldbl/mcp 到 Claude Desktop，或手动安装 MCP 服务器。 获取 API Key：在 bldbl.dev 创建账号，创建或选择项目，进入 Project Settings → AI Assistants → Generate API Key。密钥以 bp_ 开头。 配置 Claude Desktop：将配置写入 ~/.config/claude/claude_desktop_config.json，仅需 API URL 即可自动探测（最小配置）。 配置 Cursor：可在项目 Integrations 中点击 “Add to Cursor” 一键配置，或手动写入 Cursor AI 配置文件。 环境变量：建议设置 3 个环境变量以便正确追踪 AI 助手工作：BUILDABLE_API_URL、BUILDABLE_API_KEY、BUILDABLE_PROJECT_ID、BUILDABLE_AI_ASSISTANT_ID（资料称推荐 3 个，用于追踪哪个 AI 助手在项目中做了什么）。 多项目：可为不同 Buildable 项目创建不同的 MCP 服务器配置。 直接运行：也可以直接运行 MCP 服务器，并使用 CLI 与测试工具（包内提供测试工具）。
适用场景
适用于使用 Buildable 平台管理项目计划与任务的团队，希望让 Claude、GPT 等 AI 助手直接参与任务获取、执行、进度上报、完成与讨论协作的场景；也适用于需要将 AI 助手接入开发工作流并进行状态追踪的项目。
限制与说明
本软件为专有且保密的商业软件，需在 bldbl.dev 注册账号并生成 API Key 后使用；使用前需自行准备 Buildable API URL、API Key 与项目 ID。资料未提供具体定价、免费额度、支持的操作系统细节及任务类型范围。技术栈包括 TypeScript、MCP、Node.js 与 REST API。更多信息见项目主页 bldbl.dev 与文档 bldbl.dev/docs，支持邮箱 support@bldbl.dev。
