Sibyl B002 - Zo/Codex MCP Harness

Working notes for Sibyl Labs bounty B002: ship the Sibyl Memory plugin into a reproducible harness outside the default install path.

Current proof

This folder verifies the Sibyl MCP server over stdio in a Zo/Codex-style local harness and a Docker Compose harness:

• installs sibyl-memory-cli and sibyl-memory-mcp in a local Python venv
• runs sibyl health
• starts sibyl-memory-mcp over stdio
• uses an MCP client to call:
  • tools/list
  • memory_remember
  • memory_recall
• includes Docker/Compose files for a portable MCP server wrapper
• includes Codex MCP config examples for local and Docker execution

Reproduce locally

git clone https://github.com/marox-cyber/sibyl-b002-zo-codex.git
cd sibyl-b002-zo-codex
python3.12 -m venv .venv
.venv/bin/python -m pip install -U pip
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/sibyl health
.venv/bin/python scripts/verify_mcp_stdio.py

Reproduce with Docker Compose

git clone https://github.com/marox-cyber/sibyl-b002-zo-codex.git
cd sibyl-b002-zo-codex
docker compose build
docker compose run --rm verify

To run the MCP server as a stdio command from an MCP client:

docker compose run --rm sibyl-memory-mcp

For Codex, copy the relevant block from:

• examples/codex-config.local.toml
• examples/codex-config.docker.toml

Verified locally

Package install succeeded with:

• sibyl-memory-cli==0.3.17
• sibyl-memory-mcp==0.1.11
• sibyl-memory-client==0.4.15
• sibyl-memory-hermes==0.3.11

sibyl health returned all green using the local free-tier database.

scripts/verify_mcp_stdio.py successfully called the MCP server and wrote/loaded a test entity from proof-memory.db.

Docker is not available inside the current Zo container, so the Docker files are included as a portable wrapper and statically checked here. The primary B002 submission is the verified Zo/Codex MCP stdio harness.

B002 fit

• Working build others can reproduce from this repo.
• README includes setup steps.
• Verification runs against the live sibyl-memory-* packages from PyPI, not a mock.
• The repository is public for bounty review.
• Primary surface: a clean Zo/Codex MCP stdio harness. Docker Compose is included as an additional portable wrapper.