使用说明
@buildlogai/mcp
用于Buildlog的MCP服务器-搜索、跟踪和记录AI编码工作流程。
该服务器允许AI代理直接访问buildlog生态系统,使他们能够:
- 搜索 在开始任务之前查看相关工作流
- 跟随 在当前环境中经过验证的构建日志配方
- 记录 他们工作时自己的会话(默认情况下自动录制!)
- 上传 已完成的构建日志供他人学习
安装
npm install -g @buildlogai/mcp
配置
为上传设置API密钥(搜索/关注可选,上传必需):
export BUILDLOG_API_KEY=your-api-key
自动录制
默认情况下,加载后MCP服务器会自动开始录制。这确保了没有工作流丢失。
要禁用自动录制,请执行以下操作:
export BUILDLOG_AUTO_RECORD=false
当会话以有意义的内容(3个以上步骤)结束时,服务器将建议上传。
使用 buildlog_auto_status 检查自动录制是否处于活动状态。
主动建议
在开始复杂任务之前,请使用 buildlog_suggest:
Use buildlog_suggest with taskDescription "Add Stripe subscription checkout to Next.js app"
服务器将搜索相关工作流并推荐最佳匹配项。
消息来源
通过MCP创建的所有构建日志都包含源元数据:
- 工具名称和版本(
@buildlogai/mcp) - 客户端应用程序(如果可通过以下方式检测到
MCP_CLIENT任何人)
这有助于跟踪哪些工具有助于集体知识库。
用法
克劳德桌面版
添加到您的Claude桌面配置(~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"buildlog": {
"command": "buildlog-mcp"
}
}
}
光标
添加到光标MCP设置中:
{
"mcpServers": {
"buildlog": {
"command": "npx",
"args": ["@buildlogai/mcp"]
}
}
}
开爪
OpenClaw原生支持MCP服务器:
{
"mcp": {
"servers": ["buildlog-mcp"]
}
}
可用工具
| 工具 | 说明 |
|---|---|
buildlog_search |
在buildlog.ai中搜索相关工作流 |
buildlog_suggest |
在开始任务之前获取主动工作流建议 |
buildlog_get |
通过slug或URL获取特定的构建日志 |
buildlog_get_steps |
从构建日志中获取步骤 |
buildlog_follow |
获取格式化的提示以供执行 |
buildlog_record_start |
开始录制会话(或转换自动会话) |
buildlog_record_step |
记录一个步骤(提示、操作、终端、注释) |
buildlog_record_stop |
结束录制,获取构建日志 |
buildlog_auto_status |
检查自动录制状态和统计数据 |
buildlog_upload |
上传到buildlog.ai |
buildlog_fork |
从现有的构建日志开始录制 |
工具详细信息
buildlog_search
在buildlog.ai中搜索相关工作流。
Parameters:
- query (required): Search query (e.g., "stripe nextjs integration")
- language (optional): Filter by language (e.g., "typescript")
- framework (optional): Filter by framework (e.g., "nextjs")
- limit (optional): Max results (default: 10)
buildlog_suggest
在开始任务之前,获取主动的工作流程建议。在开始复杂的工作之前调用此命令。
Parameters:
- taskDescription (required): Description of what you're about to do
- contextFiles (optional): Files relevant to the task (helps improve matching)
Returns:
- Ranked list of relevant workflows
- Top recommendation with follow command
- Extracted keywords that were matched
buildlog_get
通过slug或URL获取完整的构建日志。
Parameters:
- slug (required): Buildlog slug or full URL
buildlog_get_steps
只从构建日志中获取步骤(响应更轻)。
Parameters:
- slug (required): Buildlog slug or full URL
buildlog_follow
从格式化为执行的构建日志中获取提示。这是复制工作流的关键工具。
Parameters:
- slug (required): Buildlog slug or full URL
- step (optional): Start from a specific step number
buildlog_record_start
开始录制新会话。如果自动录制处于活动状态,则会将自动会话转换为命名会话。
Parameters:
- title (required): Title for the recording
- description (optional): Longer description
buildlog_record_step
将步骤记录到活动录制中。
Parameters:
- type (required): "prompt" | "action" | "terminal" | "note"
- content (required): The step content
- metadata (optional): Additional data (filesCreated, filesModified, etc.)
buildlog_record_stop
结束录制并返回构建日志。
Parameters:
- outcome (optional): "success" | "partial" | "failure"
- summary (optional): Summary of what was accomplished
buildlog_auto_status
检查自动录制是否处于活动状态,并获取当前会话统计信息。
Parameters: none
Returns:
- autoRecordEnabled: Whether auto-record is on
- isRecording: Whether currently recording
- isAutoSession: Whether this is an auto-started session
- stats: Step count, duration, prompt/action counts
buildlog_upload
将构建日志上传到buildlog.ai。
Parameters:
- buildlog (required): The buildlog object
- public (optional): Whether publicly visible (default: true)
buildlog_fork
基于现有的构建日志开始新的录制。
Parameters:
- slug (required): Source buildlog slug
- title (required): Title for the new buildlog
- fromStep (optional): Only copy steps up to this number
示例工作流
搜索和关注
Agent: Use buildlog_search to find "stripe nextjs integration"
→ Returns list of relevant buildlogs
Agent: Use buildlog_follow on buildlog "abc123"
→ Returns prompts to execute in order
Agent: Execute each prompt, adapting to current project
录制会话
Agent: Use buildlog_record_start with title "Building auth system"
Agent: ... does work ...
Agent: Use buildlog_record_step for each significant action
Agent: Use buildlog_record_stop when done
→ Returns completed buildlog
Agent: Use buildlog_upload to share
→ Returns URL to view buildlog
分叉和延伸
Agent: Use buildlog_fork on "abc123" with title "Extended auth with MFA"
→ Starts recording with inherited steps
Agent: Use buildlog_record_step for new work
Agent: Use buildlog_record_stop
Agent: Use buildlog_upload
环境变量
| 变量 | 描述 |
|---|---|
BUILDLOG_API_KEY |
上传API密钥(从buildlog.ai/settings获取) |
BUILDLOG_API_URL |
自定义API URL(默认值:https://buildlog.ai/api) |
BUILDLOG_AUTO_RECORD |
设置为“false”以禁用自动录制(默认值:true) |
MCP_CLIENT |
源归因的客户端名称(例如“Claude Desktop”、“Cursor”) |
VS代码扩展互操作
录制时,步骤也会写入 ~/.buildlog/agent-feed.jsonl (如果目录存在)。这允许VS Code扩展将基于MCP的记录合并到其捕获流中。
链接
许可证
麻省理工学院
