<p align="center"> <img title="Runbook.AI" alt="Runbook.AI" width="20%" src="./assets/images/runbook.ai.png"> </p>

Runbook MCP 服务器

Runbook MCP 服务器使您能够从 Claude Desktop 运行您自己的 Runbook。

• 运行运维 Runbook（例如，部署服务、升级 Kubernetes 集群）
• 运行手动测试计划（例如，创建新的 EC2 实例，SSH 进入该实例，并在那里运行集成测试）。

请观看下面的演示视频，了解它的工作原理！

如何使用

要创建新的 Runbook，请使用 create_runbook 工具。 以下是一些示例提示：

示例 1

创建一个新的 Runbook：

- name: list_pods
- content: 列出所有命名空间中的 Pod，找到未就绪的 Pod，并将其发送到 Slack。

您无需解释内容。 请直接将其传递给工具。

示例 2

创建一个新的 Runbook：

- name: deploy
- content:
  1. 从 GitHub 仓库 X 获取最新的标签。 这是发布版本。
  2. 向频道 Y 发送 Slack 消息。 这会宣布 X 的部署以及版本。
  3. 运行 GitHub 工作流程，以便仓库 X 推送发布。

您无需解释内容。 请直接将其传递给工具。

要运行 Runbook，请执行以下步骤：

1. 从 Claude Desktop 点击“Attach from MCP”。
2. 从集成列表中选择 get_runbook_as_prompt。
3. 传递您要执行的 Runbook 的名称。
4. 提交生成的提示。

然后，Claude Desktop 将与其他 MCP 服务器通信以运行 Runbook。

Claude Desktop 配置

将以下配置放入 claude_desktop_config.json。

{
  "mcpServers": {
    "runbook": {
      "command": "uv",
      "args": [
        "--directory",
        "<ABSOLUTE_PATH>/runbook-mpc-server",
        "run",
        "runbook.py"
      ]
    }
  }
}

可用于运行 Runbook 的示例 MCP 服务器

• GitHub
• Slack
• DesktopCommanderMCP
• Web 搜索和浏览器自动化 (link
• Kubernetes。 有几种实现方式（例如，mcp-k8s-go）

开发计划

• 不将 Runbook 的内容保存在数据库中，而是将其保存为文件。 这有助于轻松编辑。 人们也可以简单地使用 GitHub 进行版本控制。
• 使用给定输入实例化的 Runbook 模板 X。
  • 也许不需要这个。 用户只需在运行 Runbook 时添加额外的提示。
• 保存执行日志（用于审计和改进）
  • 删除密钥
  • 如果这有助于更好地执行，还可以将过去的日志传递给 Runbook 提示
• 审批流程。
  • 添加一个工具 request_approval。
  • 这会向一个频道发送 Slack 消息。
  • 然后，Runbook MCP 服务器会监视该频道。 如果有人响应（是/否），它会继续或返回错误。
• 更好的 Runbook 搜索
  • 完全匹配名称不是很好
• 注册到 Smithery。

其可行性尚不明确的潜在工作项

注意：Claude Desktop 不支持“采样”。 这带来了一些限制。

• 子 Runbook 和可重用的执行块
• 用于管理 Runbook 的 Rest 端点 + 前端。
• 能够编辑 Runbook（带有版本控制）
• 显示 Runbook X 的执行计划（dry-run）
  • 限制 MCP 服务器和工具
• 将之前的对话转换为 Runbook
• 微调。
• 能够改进 Runbook。 如果执行成功，将其保存为示例并提供给 Claude。
• 定期执行
• 能够为运行 MCP 服务器配置环境（VM，docker）。