interchouette/ceps-rust-api-mcp repository overview

⁠ceps-rust-api-mcp

MCP sidecar for ceps-rust-api (stdio + Streamable HTTP). Agents drive Make/Docker lifecycle and call every public HTTP CEP route via ceps_api_* tools.

Product: ceps-rust-api
Source: https://github.com/Interchouette-ITC/ceps-rust-api⁠
Docs: https://github.com/Interchouette-ITC/ceps-rust-api/blob/dev/docs/mcp.md⁠

Docker Hub: interchouette/ceps-rust-api-mcp-mcp⁠
Org GHCR: ghcr.io/interchouette-itc/ceps-rust-api-mcp

Companion API image: interchouette/ceps-rust-api-mcp⁠

⁠Tags

⁠Quick start

docker pull interchouette/ceps-rust-api-mcp-mcp:dev

# Streamable HTTP on :4790
docker run --rm -d --name ceps-rust-api-mcp \
  -p 4790:4790 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v "$PWD":/workspace \
  --add-host=host.docker.internal:host-gateway \
  -e CEPS_API_ROOT=/workspace \
  -e CEPS_HOST_ROOT="$PWD" \
  -e CEPS_API_URL=http://host.docker.internal:8080 \
  interchouette/ceps-rust-api-mcp-mcp:dev

MCP endpoint: http://127.0.0.1:4790/mcp

From a clone:

make mcp-http        # pull-first sidecar
make mcp-http-stop
make run-mcp         # host stdio
make run-mcp-http    # host HTTP :4790

⁠Env

CEPS_HOST_ROOT must be an absolute host path (never /workspace, never /). Lifecycle start tools refuse when it is missing or unsafe.

⁠Tools

Prefix ceps_api_* (does not collide with ceps-client-mcp ceps18_*).

• Lifecycle: help, build, lint, test, verify, docker-run / docker-run-kms / docker-stop, start/stop host API, status
• HTTP: hello, health, openapi, put-transaction, full CEP-18/78/85/95 route wrappers

Push / version-bump Make targets are not exposed as MCP tools.

⁠Publish

• :dev → Actions CI/CD MCP Image dev (workflow_dispatch or push to dev under mcp/**)
• :X.Y.Z + :latest → CI/CD MCP Image release tags + GitHub Release

Also mirrored to personal/worker/org GHCR from Make/CI (install docs advertise Hub + org GHCR only).