# juvina-mcp

Thin MCP connector to the locally installed [Juvina](https://juvina.ai) memory engine - persistent local AI memory for coding assistants.

The engine installs with the free **Juvina Light** VS Code extension (VS Code Marketplace). This package bridges stdio MCP clients (Claude Code, any MCP host) to that engine.

## Use

```json
{ "mcpServers": { "juvina": { "command": "npx", "args": ["-y", "juvina-mcp"] } } }
```

## What it does - and does not - do

- Forwards MCP traffic to the engine's local endpoint (`localhost:8004` by default).
- Holds no data itself. Your memories live in the engine's local database on your machine; the engine's model calls go to your own endpoint on your own key.
- `JUVINA_MCP_URL` can override the target; **non-local targets are refused** unless you explicitly set `JUVINA_MCP_ALLOW_REMOTE=1`.

No engine installed? Get Juvina Light from the VS Code Marketplace - free (7-day rolling memory), or see the live demo at [juvina.ai](https://juvina.ai).

Curious what the engine can hold? We grew a fictional character from nothing but dated memories on it - no system prompt. **[Meet Merlin](https://juvina.ai/merlin/?from=gh)**.

MIT.