Runbook MCP 服务器

Runbook MCP 服务器使您能够通过 Claude Desktop 运行自己的运行手册。

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

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

如何使用

第一步：使用 Claude Desktop 启动 MCP 服务器。

创建 config.yaml

将以下配置放入 claude_desktop_config.json 中。

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

第二步：创建运行手册

您可以使用 markdown 文件或文本文件作为运行手册。参见 示例。

我们支持环境变量/变量替换。

定义 env.yaml。

env:
  key: value

• {env[key]} 将被替换为 value。
• {var.name} 将被替换为变量值。

当文件更新时重建索引。

您也可以创建一个新的运行手册，使用 create_runbook 工具。这里是一个示例提示：

示例 1

Create a new runbook:

- name: list_pods
- content: List pods in all namespaces, find pods that are not ready, and send that to Slack.

You don't need to interpret the content. Please just pass it to the tool.

第三步：运行运行手册

要运行一个运行手册，请执行以下步骤：

1. 从 Claude Desktop 中点击“从 MCP 附加”。
2. 从集成列表中选择 get_runbook_as_prompt。
3. 传递您想要执行的运行手册名称。同时指定变量，用逗号分隔（例如，var1=key1,var2=key2）。
4. 提交生成的提示。

然后 Claude Desktop 将与其他 MCP 服务器通信以运行该运行手册。

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

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

开发计划

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

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

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

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