MCP Beaker

mcp烧杯

](https://pepy.tech/projects/mcp-beaker) 

MCP服务器 烧杯 实验室自动化——系统配置、作业管理、发行版发现和故障诊断。

适用于任何Beaker服务器实例。建立在 FastMCP v3 并设计用于AI编码助手（Cursor、Claude Desktop等）。

特性

• 25工具 涵盖Beaker的整个生命周期：系统、作业、发行版、任务
• 灵活的身份验证：Kerberos（本机GSSAPI/SPNEGO或 bkr CLI回退）和密码（XML-RPC）
• 作业XML验证：自动填充缺失的字段，推断发行版系列
• 故障诊断：对可纠正的故障进行自动重试的深入分析
• 10个文档主题 作为MCP资源公开
• 2个工作流提示 用于常见任务（储备系统、诊断作业）
• 通用的：适用于任何Beaker URL，可配置SSL/CA设置

安装

容器（推荐）

容器映像将所有内容捆绑在一起——除此之外没有主机依赖关系 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

配置

光标/VS代码

添加到您的 .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）。

SSL证书： 许多Beaker服务器使用内部CA证书 不在容器的默认信任存储中。您有三个选择：

1. 禁用验证 （最简单，在可信的企业网络上很好）：

"-e", "BEAKER_SSL_VERIFY=false",

1. 通过CA证书内联 通过 BEAKER_CA_CERT_DATA （无需卷装载）：

"-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"
      }
    }
  }
}

流式HTTP模式

uvx mcp-beaker --transport streamable-http --port 8000

{
  "mcpServers": {
    "beaker": {
      "url": "http://localhost:8000/mcp",
      "type": "streamableHttp"
    }
  }
}

环境变量

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

工具

阅读工具（13）

书写工具（12）

认证

Kerberos（推荐）

确保你有一张有效的票：

kinit your-username@YOUR.REALM

服务器支持两个Kerberos后端，由 BEAKER_KERBEROS_BACKEND:

两个后端使用来自的相同Kerberos票证 kinit.

密码

集 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 (4 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/

许可证

麻省理工学院