AI编程工作流服务器

MCP服务器为AI代理提供搜索、跟随和记录编程工作流的功能,支持自动化记录和工作流分享。

  • by buildlogai
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 buildlogai/mcp

使用说明

@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的记录合并到其捕获流中。

链接

许可证

麻省理工学院