viktor/claude-memory-mcp

Viktor Barzin 20f2f02dea

add project CLAUDE.md [ci skip]

2026-03-22 23:44:38 +02:00

1.1 KiB

Raw Blame History

Claude Memory MCP

Stack

Backend: Python 3.12, FastAPI, SQLModel
Database: SQLite (local) + PostgreSQL (remote sync)
Transport: MCP over NDJSON (stdio)
Package manager: uv

Quick Start

uv sync
uv run python -m mcp.server  # Start MCP server
uv run pytest                 # Run tests

Architecture

src/ — MCP server implementation
mcp/ — MCP protocol handlers
migrations/ — Alembic database migrations
hooks/ — Claude Code hook scripts
skills/ — Claude Code skills
openclaw-plugin/ — OpenClaw integration

Key Patterns

Non-blocking startup: MCP server startup must not block on sync/HTTP calls (15s timeout)
Suppress stderr: Any stderr during startup causes Claude Code to reject the server
NDJSON transport: One JSON object per line, NOT Content-Length framing
Wrapper script: Use ~/.local/bin/claude-memory-mcp-wrapper to source secrets then exec

CI/CD

Build: GitHub Actions (Docker image push to DockerHub)
Deploy: Woodpecker CI (kubectl set image), repo ID 78
Image tags: 8-char git SHA