Skip to content
Théophile Diot.
Navigation menu
All work

BunkerWeb MCP

Open source authoring / 2025-present

A Python Model Context Protocol (MCP) server that exposes the BunkerWeb API through constrained tools and resources.

Role
Author and maintainer
Contribution
Built the Python server and its constrained API surface.
Evidence type
Linked public source
43Built-in API toolsPublic repository, 2026-08-19
3Transportsstdio, HTTP, WebSocket
1Existing authorityThe authenticated BunkerWeb API
01

The problem

An AI client needs a narrow, reviewable interface to infrastructure. Giving it raw configuration access would make ordinary operator questions harder to validate and easier to overreach.

The documented path of a tool call
Conceptual. Each stage is a documented interface, not a network hop.
02

Decisions

  1. Map API operations to typed tools with strict input validation.

    CostEach API change has to be mirrored in a tool definition before any client can use it.

  2. Use the existing authenticated API instead of adding a second privilege model.

    CostThe server can never offer more than that API already allows, including where its limits are inconvenient.

  3. Return structured resources that remain useful without a custom visual client.

    CostResponses carry structure a purpose-built interface would have supplied, so they are more verbose to read.

  4. Keep optional semantic search separate from the built-in tool surface.

    CostTwo surfaces to document and reason about, and search improvements do not reach a default install.

03

Outcome

Operators and compatible AI clients can inspect and manage BunkerWeb through an explicit protocol surface rather than editing configuration blindly.

04

Evidence and scope

Looking for a collaborator?

Share the work and its constraints. I reply by email.