Calame-Tech/calame

<p align="center"> <img src="./docs/assets/logo.png" alt="Calame" width="120" /> </p> <h1 align="center">Calame</h1> <p align="center"> <strong>Turn any database into an MCP server — visually.</strong> </p> <p align="center"> <a href="#quick-start">Quick start</a> · <a href="#features">Features</a> · <a href="#how-it-works">How it works</a> · <a href="#license">License</a> </p>

---

Calame is a self-hosted web app that connects to your PostgreSQL, MySQL, or SQLite database, lets you configure access profiles — per-table permissions, PII masking, row-level scoping — and serves them as MCP (Model Context Protocol) servers with fine-grained auth.

Plug your profile into any MCP client (LLM, Claude Desktop, Cursor, VS Code, ChatGPT Desktop…) or use the built-in chat to query your data in natural language. No code generation, no lock-in — Calame is the control plane.

Quick start

git clone https://github.com/Calame-Tech/calame.git
cd calame
pnpm install
pnpm dev

Open http://localhost:4567 — create the admin account, connect a database, create a profile, and you're live.

Or with Docker:

docker compose up

On the first run Calame auto-generates a CALAME_SECRET_KEY used to encrypt tokens and connection strings, and persists it next to your database (.calame-secret). If you deploy with Docker, mount a persistent volume on /data so that file survives restarts — otherwise every restart invalidates your saved tokens. You can also set CALAME_SECRET_KEY yourself via the environment to reuse an existing secret.

→ Detailed Quick Start — full walkthrough from install to your first MCP client query (~15 min).

Features

Database connectors

• PostgreSQL · MySQL · SQLite — schema introspection, relations, sample data
• Read-only by design (SET TRANSACTION READ ONLY), parameterized queries only
• Optional SSH tunneling for remote databases

Access profiles

• Pick tabl