Project RAG wiki

Repository-scoped MCP knowledge service for Markdown wiki content.

It indexes Markdown files from a mounted wiki folder, stores vectors in ChromaDB, and serves:

• MCP endpoint (streamable HTTP)
• health endpoint

The MCP surface is intentionally small at the moment:

• Active tools: wiki_search, wiki_read, wiki_list, wiki_write, wiki_append

Agent Harness

For an agent consumer of this service, see @ihorleleka/harness.

What This Image Expects

• A wiki folder mounted at /workspace/wiki
• A writable KB state folder mounted at /workspace/.kb
• A shared models cache KB state folder mounted at /root/.cache/huggingface/hub

Do not bake runtime .kb state into images.

Runtime Defaults

• KB_WIKI_ROOT=/workspace/wiki
• KB_ROOT=/workspace/.kb
• KB_PORT=1111
• KB_MCP_PATH=/mcp/
• KB_HEALTH_PATH=/health
• KB_EMBEDDING_MODEL=all-MiniLM-L6-v2
• KB_CHUNK_SIZE=500
• KB_CHUNK_OVERLAP=150
• KB_TOP_K=8
• KB_MERGE_ADJACENT_WINDOW=1
• KB_WATCH_INTERVAL_SECONDS=15

Run

docker run --rm \
  -p 1111:1111 \
  -v "$(pwd)/wiki:/workspace/wiki" \
  -v "$(reponame)-kb-data:/workspace/.kb" \
  -v "kb-models:/root/.cache/huggingface/hub" \
  ihorleleka/project-rag-wiki:latest

Release Automation

Image versioning is driven from the Git tag.

• Tag releases as X.Y.Z.
• The GitHub Actions workflow at [.github/workflows/docker-release.yml] builds and pushes the Docker image on tag pushes.
• The workflow passes the tag name directly into the Docker build as VERSION.
• That same VERSION value is used for the OCI image label and the installed Python package version inside the image.

Set these repository settings before using the workflow:

• Secret DOCKERHUB_USERNAME
• Secret DOCKERHUB_TOKEN

Endpoints

• Health: GET /health
• MCP: POST /mcp/ (also mounted at /mcp)

The health response is 200 only when the service startup reindex has completed successfully and the MCP session manager is running.

License

MIT. See LICENSE.