Skip to main content
Glama
deenesjakoruzh
faizbawa

mcp-beaker

by faizbawa
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

mcp-beaker

PyPI Version PyPI Downloads CI License Python

用于 Beaker 实验室自动化的 MCP 服务器 —— 系统供应、作业管理、distro 发现和失败诊断。

适用于任何 Beaker 服务器实例。基于 FastMCP v3 构建，专为 AI 编码助手（Cursor、Claude Desktop 等）设计。

功能特性

  • 27 个工具，覆盖 Beaker 的完整生命周期：系统、作业、distro、任务

  • Beaker Py3 兼容：同时兼容传统和现代化 Beaker REST API

  • 灵活的验证方式：Kerberos（原生 GSSAPI/SPNEGO 或 bkr CLI 回退）和密码（XML-RPC）

  • 作业 XML 验证：自动填充缺失字段，推断 distro 系列

  • 失败诊断：深度分析，并自动重试可纠正的失败

  • 10 个文档主题，作为 MCP 资源提供

  • 2 个工作流程提示，用于常见任务（保留系统、诊断作业）

  • 通用：适用于任何 Beaker URL，支持配置 SSL/CA 设置

Related MCP server: zuul-mcp

安装

容器（推荐）

容器镜像捆绑了所有必要内容 —— 宿主机只需要 podman（或 docker），无需其他依赖。Kerberos 认证在容器内通过 KRB5_PRINCIPAL 和 KRB5_PASSWORD 环境变量完成。

# Pull the pre-built image from GHCR
podman pull ghcr.io/faizbawa/mcp-beaker:latest

# Or build locally from the repo
podman build -t mcp-beaker:latest -f Containerfile .

Pip / uvx

# Using uv (recommended)
pip install uv
uvx mcp-beaker

# Using pip
pip install mcp-beaker
mcp-beaker

# With native Kerberos support (no bkr CLI needed -- requires krb5-devel on host)
pip install mcp-beaker[kerberos]

# Local development
uv run --directory /path/to/mcp-beaker mcp-beaker

配置

Cursor / VS Code

将以下内容添加到 .cursor/mcp.json（或 .vscode/mcp.json）：

容器（推荐）

{
  "mcpServers": {
    "beaker": {
      "command": "podman",
      "args": [
        "run", "--rm", "-i", "--network=host",
        "-e", "BEAKER_URL=https://beaker.example.com",
        "-e", "KRB5_PRINCIPAL=your-user@YOUR.REALM",
        "-e", "KRB5_PASSWORD=your-kerberos-password",
        "ghcr.io/faizbawa/mcp-beaker:latest"
      ]
    }
  }
}

容器内部运行 kinit —— 无需挂载卷，无需宿主机依赖。使用 --network=host 让容器能访问你的 Kerberos KDC 和 Beaker 服务器（尤其是在 VPN 下）。

使用挂载的 kerberos 票据的容器（配置中无需密码）

无需在 mcp.json 中存储 Kerberos 密码，你可以在宿主机上挂载一个现有的 kerberos 票据缓存：

步骤 1 —— 在宿主机上创建文件型 kerberos 票据：

kinit -c FILE:/tmp/krb5cc_beaker your-user@YOUR.REALM

每当票据过期（通常每 10 小时）时，重新运行此命令。

步骤 2 —— 将票据挂载到容器中：

{
  "mcpServers": {
    "beaker": {
      "command": "podman",
      "args": [
        "run", "--rm", "-i", "--network=host",
        "-v", "/tmp/krb5cc_beaker:/tmp/krb5cc_0:ro,Z",
        "-e", "BEAKER_URL=https://beaker.example.com",
        "ghcr.io/faizbawa/mcp-beaker:latest"
      ]
    }
  }
}

容器检测到有效票据并完全跳过 kinit。无需 KRB5_PRINCIPAL 或 KRB5_PASSWORD。:ro,Z 挂载标志确保只读访问，并带有正确的 SELinux 标签。

注意： 宿主机通常使用 KCM（D-Bus）来存储凭证，容器无法访问。这就是为什么你需要 kinit -c FILE:... 来创建基于文件的缓存，以便可以将其绑定挂载。

SSL 证书： 许多 Beaker 服务器使用内部的 CA 证书，这些证书不在容器的默认信任库中。你有三种选择：

  1. 禁用验证（最简单，在可信的办公网络中没问题）：

"-e", "BEAKER_SSL_VERIFY=false",

  1. 通过 BEAKER_CA_CERT_DATA 直接传入 CA 证书（无需挂载卷）：

"-e", "BEAKER_CA_CERT_DATA=-----BEGIN CERTIFICATE-----\nMIID...your-ca-cert...\n-----END CERTIFICATE-----",

  1. 挂载一个 CA 证书包（单个文件）：

"-v", "/path/to/ca-bundle.crt:/tmp/ca-bundle.crt:ro",
"-e", "BEAKER_CA_CERT=/tmp/ca-bundle.crt",

Pip / uvx

{
  "mcpServers": {
    "beaker": {
      "command": "uvx",
      "args": ["mcp-beaker[kerberos]"],
      "env": {
        "BEAKER_URL": "https://beaker.example.com",
        "BEAKER_AUTH_METHOD": "kerberos",
        "BEAKER_KERBEROS_BACKEND": "http"
      }
    }
  }
}

Streamable HTTP 模式

uvx mcp-beaker --transport streamable-http --port 8000
{
  "mcpServers": {
    "beaker": {
      "url": "http://localhost:8000/mcp",
      "type": "streamableHttp"
    }
  }
}

环境变量

变量

必需

默认值

说明

BEAKER_URL

是

--

你的 Beaker 服务器的基础 URL

BEAKER_AUTH_METHOD

否（默认 kerberos）

kerberos

kerberos 或 password

BEAKER_KERBEROS_BACKEND

否

http

http（原生 SPNEGO）或 bkr（bkr CLI）

BEAKER_USERNAME

使用密码时

--

Beaker 用户名

BEAKER_PASSWORD

使用密码时

--

Beaker 密码

BEAKER_OWNER

否

$USER

作业查询的默认所有者

BEAKER_SSL_VERIFY

否

true

是否验证 SSL 证书

BEAKER_CA_CERT

否

--

CA 证书包的路径

KRB5_PRINCIPAL

仅容器

--

容器内执行 kinit 所需的主体的 principal

KRB5_PASSWORD

仅容器

--

容器内执行 kinit 所需的密码

BEAKER_CA_CERT_DATA

仅容器

--

启动时写入文件的 PEM 编码 CA 证书

CLI 选项

mcp-beaker [OPTIONS]

Options:
  --transport [stdio|sse|streamable-http]  Transport type (default: stdio)
  --port INTEGER                           Port for HTTP transports (default: 8000)
  --host TEXT                              Host for HTTP transports (default: 0.0.0.0)
  --path TEXT                              Path for streamable-http (default: /mcp)
  --beaker-url TEXT                        Beaker server URL
  --ssl-verify / --no-ssl-verify           Verify SSL certs (default: verify)
  --ca-cert TEXT                           CA certificate bundle path
  --auth-method [kerberos|password]        Authentication method
  --kerberos-backend [http|bkr]            Kerberos backend (default: http)
  --read-only                              Disable all write tools
  --enabled-tools TEXT                     Comma-separated tools to enable
  -v, --verbose                            Increase verbosity (-v info, -vv debug)
  --version                                Show version
  --help                                   Show this message

工具

读工具（15）

工具

说明

list_systems

按可用性（all/available/free）列出系统

search_systems

按 CPU、架构、内存、资源池及其他硬件属性搜索系统

get_system_details

硬件的详细规格、CPU 信息、资源池成员资格、所有权、状态

get_system_status

当前状态、保留情况（reservation）、借用状态（loan）

get_system_history

一个系统的活动历史

get_system_arches

支持的 OS 系列和架构

list_jobs

按所有者、状态、 whiteboard 过滤作业

get_job_status

作业状态，包含失败诊断信息

get_job_results_xml

以 XML 格式导出作业结果

get_job_logs

列出作业/配方/任务的日志文件

list_distro_trees

按名称、家族、架构、标签搜索发行版

list_os_families

列出所有已知的操作系统家族

each

显示当前已认证用户的信息

list_lab_controllers

列出所有实验室控制器

search_tasks

在任务库中搜索

写工具（12）

工具

说明

submit_job

从 XML 提交作业（含校验和自动填充）

clone_job

启动并重新提交一个现有作业，生成一个新的克隆

cancel_job

取消正在运行/被排队的作业

watch_job

轮询直到作业完成，包含故障分析和自动重试

reserve_system

手动保留一个系统

release_system

释放手动保留的系统

loan_system

将系统授权借用给某个用户

return_loan

归还当前系统借出

power_system

打开/关闭/重启系统

provision_system

为已保留的系统使用某个 distro 进行小规模初始化

extend_watchdog

延长当前任务的操作看门狗定时器

set_job_response

确认/拒绝（waive）一个配方集的结果

认证

Kerberos（推荐）

确保你有一张有效的 Kerberos 票据：

kinit your-username@YOUR.REALM

服务器支持两种 Kerberos 后端，由 BEAKER_KERBEROS_BACKEND 控制：

值

后端

安装方式

http（默认）

原生 GSSAPI/SPNEGO —— 轻量，可通过 pip 安装

pip install mcp-beaker[kerberos]

bkr

bkr CLI 子进程 —— 传统方式，需要安装 RPM

yum install beaker-client

两者后端都使用 kinit 产生的同一张 Kerberos 票据。

密码

设置 BEAKER_AUTH_METHOD=password，同时设置 BEAKER_USERNAME 和 BEAKER_PASSWORD。服务器通过 XML-RPC 的 auth.login_password() 方法进行认证。注意：这需要服务器端启用 LDAP。

架构

src/mcp_beaker/
  __init__.py           # Click CLI entry point
  config.py             # BeakerConfig dataclass
  exceptions.py         # Custom exceptions
  client.py             # BeakerClient (XML-RPC + REST)
  models/               # Pydantic response models
  servers/
    __init__.py         # FastMCP server, lifespan, DI helper
    systems.py          # System tools (6 read + 6 write)
    jobs.py             # Job tools (4 read + 6 write)
    distros.py          # Distro tools (2 read)
    tasks.py            # Task tools (1 read)
    general.py          # General tools (2 read)
    prompts.py          # Workflow prompt templates
    resources.py        # Beaker documentation resources
  utils/
    xml_validation.py   # Job XML validation/auto-fill
    diagnosis.py        # Failure analysis engine
    formatting.py       # Human-readable formatters
    bkr_cli.py          # bkr CLI helpers
    parsing.py          # ID parsing utilities

开发

cd mcp-beaker
uv sync --dev
uv run pytest
uv run ruff check src/

许可证

MIT

Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
1wRelease cycle
19Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • zuul-mcp

    clappingmonkey
    A
    license
    Not graded
    quality
    B
    maintenance
    MCP server for Zuul CI/CD with 25 tools for builds, pipelines, queue management (enqueue/dequeue/promote), infrastructure visibility, and autohold management. Supports stdio, HTTP, and SSE transports.
    MIT

  • jakubs-mcp-tools

    Jakub2841
    F
    license
    Not graded
    quality
    C
    maintenance
    MCP server for infrastructure discovery and remote management, enabling SSH command execution, file transfer, log tailing, and machine/service inventory with a companion web dashboard.
    1

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/faizbawa/mcp-beaker'

If you have feedback or need assistance with the MCP directory API, please join our Discord server