ContextVault

ContextVault

Shared context storage for AI agents. Any MCP-compatible model (Claude, ChatGPT, Gemini) can store, read, and search context entries through the MCP server. A web UI lets you browse and manage everything.

Architecture

  Claude / ChatGPT / Gemini
        │ (MCP stdio)
        ▼
  ┌──────────────┐
  │  MCP Server   │──────┐
  └──────────────┘      │
                         ▼
  ┌──────────────┐   ┌──────────┐
  │   Web UI      │──▶│ Express  │──▶ PostgreSQL
  └──────────────┘   └──────────┘

• Express API (src/index.ts) — REST API + serves the React UI
• MCP Server (src/mcp.ts) — stdio MCP server for AI agents
• PostgreSQL — persistent storage with JSONB tags and GIN index

Quick Start (Docker)

docker compose up

Open http://localhost:3000 for the UI. Postgres runs on port 5432.

Local Development

Prerequisites: Node.js 20+, PostgreSQL running locally.

# Create the database
createdb context_vault

# Install and build
npm install
cd client && npm install && npm run build && cd ..
npm run build:server

# Start the web server
npm start

# Or run the MCP server for AI agents
npm run mcp

Set DATABASE_URL env var if your Postgres isn't at the default postgresql://postgres:postgres@localhost:5432/context_vault.

MCP Configuration

Claude Code / Claude Desktop

{
  "mcpServers": {
    "context-vault": {
      "command": "node",
      "args": ["/absolute/path/to/context-vault/dist/mcp.js"],
      "env": {
        "DATABASE_URL": "postgresql://postgres:postgres@localhost:5432/context_vault"
      }
    }
  }
}

Deploy to GCP (Cloud Run)

# Build and push
gcloud builds submit --tag gcr.io/PROJECT_ID/context-vault

# Deploy
gcloud run deploy context-vault \
  --image gcr.io/PROJECT_ID/context-vault \
  --set-env-vars DATABASE_URL=postgresql://... \
  --port 8080 \
  --allow-unauthenticated

API

| Method | Path | Description | |--------|------|-------------| | GET | /api/stats | Dashboard stats | | GET | /api/namespaces | List namespaces | | GET | /api/entries | List entries (query: namespace, source, tag) | | GET | /api/entries/search?q= | Search entries | | GET | /api/entries/:ns/:key | Get one entry | | POST | /api/entries | Create/upsert entry | | PUT | /api/entries/:ns/:key | Update entry | | DELETE | /api/entries/:ns/:key | Delete entry |

MCP Tools

| Tool | Description | |------|-------------| | store | Store or upsert a context entry | | get | Retrieve a specific entry | | update | Partially update an entry | | delete | Delete an entry | | list | List entries with filters | | search | Search by keyword | | namespaces | List all namespaces |