@ztell/context-vault-mcp
v0.1.0
Published
MCP server for Context Vault — give AI tools native access to your personal context.
Downloads
32
Maintainers
Readme
Context Vault MCP Server
Give Claude, Cursor, Windsurf, and other AI tools native access to your personal context — without prompt injection or copy-pasting.
Context Vault stores your preferences, communication style, active projects, corrections, and personal background. This MCP server lets any MCP-compatible AI tool retrieve that context automatically.
Quick Start
1. Get your API key
Sign up at aiglue.ai, go to Settings → API Key, and generate a cv_ key.
2. Add to Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"context-vault": {
"command": "npx",
"args": ["-y", "context-vault-mcp"],
"env": {
"CONTEXT_VAULT_API_KEY": "cv_your_api_key_here"
}
}
}
}3. Add to Cursor
Edit ~/.cursor/mcp.json:
{
"mcpServers": {
"context-vault": {
"command": "npx",
"args": ["-y", "context-vault-mcp"],
"env": {
"CONTEXT_VAULT_API_KEY": "cv_your_api_key_here"
}
}
}
}4. Add to Windsurf
Edit ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"context-vault": {
"command": "npx",
"args": ["-y", "context-vault-mcp"],
"env": {
"CONTEXT_VAULT_API_KEY": "cv_your_api_key_here"
}
}
}
}How It Works
┌──────────────────┐ MCP Protocol ┌──────────────────┐ HTTPS ┌──────────────────┐
│ Claude Desktop │ ◄──────────────────► │ MCP Server │ ◄───────────► │ Context Vault │
│ Cursor / etc. │ │ (this package) │ │ API │
│ │ │ │ │ api.aiglue.ai │
└──────────────────┘ └──────────────────┘ └──────────────────┘- You store your context entries in Context Vault (via the web app or Chrome extension)
- This MCP server authenticates with your
cv_API key - When an AI tool needs your context, it calls the MCP tools
- The server fetches your entries from the Context Vault API
- PHI-flagged entries are excluded by default (HIPAA compliance)
Tools
get_context
Retrieve your full personal context, formatted for AI consumption. Use this at the start of a conversation so the AI understands who you are.
| Parameter | Type | Required | Description |
|-----------|--------|----------|-------------|
| platform | string | No | Target platform: claude, chatgpt, manus, grok, perplexity, gemini |
| format | string | No | Response format: text, json, markdown |
| category | string | No | Filter: style, personal, work, projects, tools, corrections |
get_summary
Quick vault overview — entry counts by category, platforms configured, last update. No parameters.
search_context
Keyword search across your context entries.
| Parameter | Type | Required | Description | |----------|--------|----------|-------------| | query | string | Yes | Search query (1-200 chars) | | platform | string | No | Filter by platform |
Environment Variables
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| CONTEXT_VAULT_API_KEY | Yes | — | Your cv_ API key from aiglue.ai |
| CONTEXT_VAULT_API_URL | No | https://api.aiglue.ai | API base URL (for self-hosted or staging) |
PHI Safety
Entries flagged as containing Protected Health Information (PHI) are never returned by any MCP tool. The API filters them server-side. The include_phi parameter is not exposed through the MCP server.
Security
- Your API key is stored locally in your MCP config file
- The key is never sent to Anthropic — it only goes to the Context Vault API
- All API communication uses HTTPS
- The MCP server runs locally on your machine
- No data is cached or persisted by the MCP server
Development
git clone https://github.com/Ad-Vital/context-vault-mcp.git
cd context-vault-mcp
pnpm install
CONTEXT_VAULT_API_KEY=cv_test pnpm devTroubleshooting
"CONTEXT_VAULT_API_KEY is not set"
Make sure the env block in your MCP config includes the key. Get one at aiglue.ai → Settings → API Key.
Claude does not show the hammer icon
- Restart Claude Desktop after editing the config
- Check Claude Desktop logs: Help → Show Logs
- Ensure Node.js 18+ is installed
"Context Vault API error: Authentication required"
- Verify your API key starts with
cv_ - Regenerate the key in the web app if needed
- Make sure there are no extra spaces in the key
License
MIT — Ad Vital, Inc.
