Context Bridge

Bridge the context gap between your codebase and AI coding tools.

Context Bridge is a lightweight MCP (Model Context Protocol) server that builds a persistent semantic knowledge graph of your codebase. It enables AI assistants to query complex codebases with sub-millisecond latency, eliminating the need to re-read files every session.

Why?

AI coding tools are powerful but suffer from a context gap:

• They re-read the same files in every session

• They lack deep understanding of your architecture

• They can't learn from your coding conventions

• 23 minutes of developer focus are lost per context switch

Context Bridge solves this by indexing your codebase into a local knowledge graph that persists across sessions.

Related MCP server: CodeRAG

Features

• Semantic Code Search — Query code with natural language

• Persistent Knowledge Graph — SQLite-based, survives restarts

• Sub-millisecond Queries — FTS5 + precomputed embeddings

• MCP Protocol — Works with Claude Code, Cursor, and any MCP client

• Auto-indexing — Watches files and updates the index automatically

• Zero Cloud — Everything runs locally

Quick Start

# Install globally
npm install -g context-bridge

# Initialize in your project
cd your-project
context-bridge init

# Start the MCP server
context-bridge serve

# Or use with Claude Code
claude mcp add context-bridge -- node context-bridge serve

Configuration

Create .context-bridge.json in your project root:

{
  "include": ["src/**/*.{js,ts,jsx,tsx}", "lib/**/*.py"],
  "exclude": ["node_modules/**", "dist/**", "*.test.js"],
  "dbPath": ".context-bridge/db.sqlite",
  "watch": true,
  "maxFileSizeKB": 500
}

MCP Tools

Architecture

┌─────────────────┐     ┌──────────────┐     ┌────────────────┐
│  Claude Code    │────▶│ Context      │────▶│ SQLite + FTS5  │
│  Cursor         │     │ Bridge MCP   │     │ Knowledge Graph│
│  Other MCP      │◀────│ Server       │◀────│ (persistent)   │
│  Clients        │     │              │     │                │
└─────────────────┘     └──────────────┘     └────────────────┘
                               │
                               ▼
                        ┌──────────────┐
                        │ File Watcher │
                        │ (auto-index) │
                        └──────────────┘

License

MIT