Skip to main content
Glama
arsenkylyshbek

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

Related MCP server: Memclaw

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI tools like GitHub Copilot to manage and persist context using a local JSON-based memory store. Provides CLI, MCP server, and VS Code integration for storing, retrieving, and managing context entries.
    2
    -
  • A
    license
    Not graded
    quality
    A
    maintenance
    Governed shared memory platform for AI agents and agent fleets. Provides persistent memory, cross-agent knowledge sharing, permissions, audit trails, and multi-tenant isolation through a Model Context Protocol (MCP) server.
    4 npm
    526
    Apache 2.0