运行手册
MCP服务器，将YAML中定义的开发任务作为MCP工具公开。
安装
curl -fsSL https://runbookproduction.z13.web.core.windows.net/install.sh | bash构建
go build -o bin/runbook main.go或者使用make：
make build配置
服务器按以下顺序查找配置：
- 通过给出的路径
-config标志（文件或目录） .runbook/目录--全部*.yaml文件会自动合并
创建一个 .runbook/ 包含一个或多个YAML文件的目录：
.runbook/
tasks.yaml
daemons.yaml
prompts.yaml每个文件都是一个标准清单。它们被合并在一起——任务名称、工作流名称和提示名称在文件中必须是唯一的。
覆盖文件
地点a .runbook.overrides.yaml 在项目根目录下，无需编辑配置文件即可控制任务可见性。任务名称支持全局模式。
# .runbook.overrides.yaml
tasks:
deploy:
disabled: true # fully disable (CLI + MCP)
ts-*:
disable_mcp: true # hide from AI, keep CLI access
workflows:
ci:
disabled: true覆盖文件是可选的，如果它不存在，则会被忽略。
示例
.runbook/tasks.yaml:
version: "1.0"
tasks:
test:
description: "Run tests"
command: "go test ./..."
type: oneshot
dev:
description: "Start dev server"
command: "npm run dev"
type: daemon命令行用法
直接从命令行运行任务：
runbook list # List all available tasks
runbook run [--param=value...] # Run a oneshot task or workflow
runbook start [--param=value...] # Start a daemon
runbook stop # Stop a daemon
runbook status # Show daemon status
runbook logs [--lines=N] [--filter=REGEX] [--session=ID]所有子命令均接受 --config=path 指定自定义配置位置。
示例
# List tasks defined in your config
runbook list
# Run a task
runbook run build
# Run a parameterized task
runbook run go_test --flags="-v -race" --package="./..."
# Start/stop a daemon
runbook start dev
runbook stop dev
runbook status dev
# View logs
runbook logs dev --lines=50
runbook logs dev --filter="ERROR"任务输出到stdout（管道）。状态和元数据将转到stderr。
提示模板
提示支持Go模板语法。使用 run_task 引用任务工具名称——这适用于任何任务名称，包括包含连字符的任务名称：
prompts:
dev-workflow:
description: "How to work on this project"
content: |
Run tests: {{run_task "my-tests"}}
Start server: {{run_task "dev-server"}}{{run_task "my-tests"}} 解析为 run_my-tests。对于没有连字符的任务名称，点访问也适用： {{.Tasks.build.Run}} → run_build.
使用MCP
添加到您的 .mcp.json:
{
"mcpServers": {
"runbook": {
"command": "/path/to/runbook"
}
}
}发展
make test # Run tests
make lint # Run linter
make build # Build binary to bin/runbook
make install # Install to $HOME/.bin/runbook