# app-svc-mempalace

MemPalace MCP server — exposes the [mempalace](https://github.com/MemPalace/mempalace) memory tools over HTTP MCP for agent consumption.

## What it does

Wraps `python -m mempalace mcp` (stdio) with `mcp-proxy` to serve MCP over HTTP/SSE on port 8765. A FastAPI health endpoint runs on port 8080.

## Architecture

```
Agent (VS Code / Claude)
  → Cloudflare Access (auth)
    → Cloudflare Tunnel
      → Istio HTTPRoute (mempalace.treistack.com)
        → mcp-proxy (:8765)
          → python -m mempalace mcp (stdio)
            → ChromaDB (local vector store, PVC-backed)
```

## Image

Published to `ghcr.io/trei-stacks/app-svc-mempalace` on every release.

## Cluster deployment

The cluster deployment lives in `gitops-k8s-platform/clusters/talos-home-lab/platform/mempalace/`.  
On release, the GitOps workflow opens a PR to update the image tag.

## Environment variables

| Variable | Default | Description |
|---|---|---|
| `MCP_PORT` | `8765` | Port for mcp-proxy (MCP HTTP transport) |
| `HEALTH_PORT` | `8080` | Port for FastAPI health endpoint |
| `MEMPALACE_PALACE_DIR` | `/data/palace` | Directory where mempalace stores its palace data |