Runbook MCP Server

Runbook MCP Server

site icon
2025.04.12 1
Python工作流自动化运维工具测试自动化开发效率
Runbook MCP Server 是一个用于从 Claude Desktop 运行自定义 runbook 的服务。它允许用户创建和执行各种操作手册(runbooks),例如部署服务、升级 Kubernetes 集群、运行手动测试计划等。该服务支持与多个 MCP 服务器集成,如 GitHub、Slack、Kubernetes 等,以实现自动化工作流程。
View on GitHub

Overview

基本能力

产品定位

Runbook MCP Server 是一个用于自动化操作和测试的工作流管理工具,特别适合开发者和运维人员使用。

核心功能

  1. 创建和运行操作手册(runbooks)。
  2. 支持多种操作场景,如部署服务、升级集群、运行测试等。
  3. 与多个 MCP 服务器集成(GitHub、Slack、Kubernetes 等)。
  4. 提供简单的配置和运行方式。

适用场景

  1. 运维操作自动化(如部署服务、升级集群)。
  2. 手动测试计划的自动化执行。
  3. 与第三方服务(如 GitHub、Slack)的集成工作流。

工具列表

  1. create_runbook:用于创建新的 runbook。
  2. get_runbook_as_prompt:用于获取并执行 runbook。
  3. request_approval(计划中):用于请求审批流程。

常见问题解答

  1. 如何创建 runbook?使用 create_runbook 工具并按照示例格式提供内容。
  2. 如何运行 runbook?通过 Claude Desktop 的 "Attach from MCP" 功能选择 get_runbook_as_prompt 并提交 runbook 名称。
  3. 如何配置 Claude Desktop?编辑 claude_desktop_config.json 文件并添加 runbook 服务器的配置。

使用教程

使用依赖

  1. 确保已安装 Claude Desktop。
  2. 确保已安装 Python 和必要的依赖(如 uv)。

安装教程

  1. 克隆或下载 runbook-mcp-server 仓库。
  2. 配置 claude_desktop_config.json 文件,指定 runbook 服务器的路径。 json { "mcpServers": { "runbook": { "command": "uv", "args": [ "--directory", "<ABSOLUTE_PATH>/runbook-mpc-server", "run", "runbook.py" ] } } }
  3. 启动 Claude Desktop 并加载配置。

调试方式

  1. 确保 runbook 服务器路径配置正确。
  2. 检查 Claude Desktop 是否成功加载了 runbook 服务器。
  3. 尝试创建并运行一个简单的 runbook 以验证功能。 ``` Create a new runbook:
  4. name: test_runbook
  5. content: echo "Hello, World!" ```

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。