charly-mcp
| Version | 2026.243.0100 |
| Repo | box/github.com/opencharly/pod-charly-mcp:v2026.243.0516 |
An MCP server exposing the full charly CLI as Streamable-HTTP tools on port 18765
charly-mcp is a meta-composition (candy: [charly, supervisord]) with no
install of its own: it bakes the charly binary + supervisord, runs
charly mcp serve --listen :18765 as a supervised service, and threads
CHARLY_PROJECT_DIR=/workspace plus a world-writable /workspace project
mount so build-mode tools (box.build, box.list.*) can resolve a project
checkout. Verifiable at build (the composed charly binary and the
/workspace mount land in the image) and at deploy (the MCP endpoint comes
up and enumerates tools derived from the charly Kong CLI model).
Services
Section titled “Services”charly-mcp
Acceptance plan
Section titled “Acceptance plan”This candy’s plan: — the runnable spec charly check executes against a live deployment. check: steps are idempotent probes; run: steps change state.
| Intent | Step |
|---|---|
run |
mkdir=/workspace |
run |
seed a placeholder project so the MCP server resolves locally, not over the network |
run |
restamp the placeholder to this image’s own schema version |
check |
the composed charly candy bakes the charly CLI binary at /usr/bin/charly |
check |
the world-writable /workspace project mount exists in the built image |
check |
the placeholder project is seeded, so the MCP server never reaches the network for one |
check |
the supervised charly-mcp service is running |
check |
the MCP endpoint enumerates charly CLI tools over Streamable HTTP |
agent-check |
the charly-mcp service keeps answering MCP clients on port 18765, restarting automatically (restart=always) if the charly mcp serve process exits |
check |
addr=127.0.0.1:${HOST_PORT:18765} |
check |
mcp=ping |
check |
mcp=list-tools |
check |
mcp=call |
check |
mcp=call |