@@ -46,22 +46,22 @@ claude mcp add codebase-context -- npx -y codebase-context
4646
4747The server runs in two modes. Use stdio unless you need multiple clients connected at once:
4848
49- | Mode | How it runs | When to use |
50- | ---- | ----------- | ------------ |
51- | ** stdio** (default) | Process spawned by the client | One AI client talking to one or more repos |
52- | ** HTTP** | Long-lived server at ` http://127.0.0.1:3100/mcp ` | Multiple clients sharing one server |
49+ | Mode | How it runs | When to use |
50+ | ------------------- | ------------------------------------------------ | ------------------------------ ------------ |
51+ | ** stdio** (default) | Process spawned by the client | One AI client talking to one or more repos |
52+ | ** HTTP** | Long-lived server at ` http://127.0.0.1:3100/mcp ` | Multiple clients sharing one server |
5353
5454Client support at a glance:
5555
56- | Client | stdio | HTTP |
57- | ------ | ----- | ---- |
58- | Claude Code | Yes | No (stdio only) |
59- | Claude Desktop | Yes | No |
60- | Cursor | Yes | Yes — ` .cursor/mcp.json ` with ` type: "http" ` |
61- | Windsurf | Yes | Not yet |
62- | Codex | Yes | Yes — ` --mcp-config ` flag |
63- | VS Code (Copilot) | Yes | No |
64- | OpenCode | Yes | Not documented yet |
56+ | Client | stdio | HTTP |
57+ | ----------------- | ----- | ---------------------------------------- ---- |
58+ | Claude Code | Yes | No (stdio only) |
59+ | Claude Desktop | Yes | No |
60+ | Cursor | Yes | Yes — ` .cursor/mcp.json ` with ` type: "http" ` |
61+ | Windsurf | Yes | Not yet |
62+ | Codex | Yes | Yes — ` --mcp-config ` flag |
63+ | VS Code (Copilot) | Yes | No |
64+ | OpenCode | Yes | Not documented yet |
6565
6666Copy-pasteable templates: [ ` templates/mcp/stdio/.mcp.json ` ] ( ./templates/mcp/stdio/.mcp.json ) and [ ` templates/mcp/http/.mcp.json ` ] ( ./templates/mcp/http/.mcp.json ) .
6767
@@ -106,28 +106,28 @@ Memory types: `convention`, `decision`, `gotcha`, `failure`. Confidence decay: c
106106
107107## Tools
108108
109- | Tool | What it does |
110- | ---- | ------------ |
111- | ` search_codebase ` | Hybrid search + decision card when ` intent="edit" ` |
112- | ` get_team_patterns ` | Pattern frequencies, golden files, conflict detection |
113- | ` get_symbol_references ` | Concrete references to a symbol (count + snippets) |
114- | ` remember ` | Record a convention, decision, gotcha, or failure |
115- | ` get_memory ` | Query team memory with confidence decay scoring |
116- | ` get_codebase_metadata ` | Project structure, frameworks, dependencies |
117- | ` get_style_guide ` | Style guide rules for the current project |
118- | ` detect_circular_dependencies ` | Import cycles between files |
119- | ` refresh_index ` | Full or incremental re-index + git memory extraction |
120- | ` get_indexing_status ` | Progress and stats for the current index |
109+ | Tool | What it does |
110+ | ------------------------------ | ----------------------------------------- ------------ |
111+ | ` search_codebase ` | Hybrid search + decision card when ` intent="edit" ` |
112+ | ` get_team_patterns ` | Pattern frequencies, golden files, conflict detection |
113+ | ` get_symbol_references ` | Concrete references to a symbol (count + snippets) |
114+ | ` remember ` | Record a convention, decision, gotcha, or failure |
115+ | ` get_memory ` | Query team memory with confidence decay scoring |
116+ | ` get_codebase_metadata ` | Project structure, frameworks, dependencies |
117+ | ` get_style_guide ` | Style guide rules for the current project |
118+ | ` detect_circular_dependencies ` | Import cycles between files |
119+ | ` refresh_index ` | Full or incremental re-index + git memory extraction |
120+ | ` get_indexing_status ` | Progress and stats for the current index |
121121
122122## Multi-project
123123
124124One server, multiple repos. Three cases:
125125
126- | Case | What happens |
127- | ---- | ------------ |
128- | One project | Routing is automatic |
129- | Multiple projects, active project already set | Routes to the active project |
130- | Multiple projects, ambiguous | Returns ` selection_required ` — retry with ` project ` |
126+ | Case | What happens |
127+ | --------------------------------------------- | --------------------------------------- ------------ |
128+ | One project | Routing is automatic |
129+ | Multiple projects, active project already set | Routes to the active project |
130+ | Multiple projects, ambiguous | Returns ` selection_required ` — retry with ` project ` |
131131
132132` project ` accepts a project root path, file path, ` file:// ` URI, or relative subproject path (e.g. ` apps/dashboard ` ).
133133
@@ -149,16 +149,16 @@ If you get `selection_required`, retry with one of the paths from `availableProj
149149
150150## Configuration
151151
152- | Variable | Default | Description |
153- | -------- | ------- | ----------- |
154- | ` EMBEDDING_PROVIDER ` | ` transformers ` | ` openai ` (fast, cloud) or ` transformers ` (local, private) |
155- | ` OPENAI_API_KEY ` | — | Required only if using ` openai ` provider |
156- | ` CODEBASE_ROOT ` | — | Bootstrap root for CLI and single-project MCP clients |
157- | ` CODEBASE_CONTEXT_DEBUG ` | — | Set to ` 1 ` for verbose logging |
158- | ` EMBEDDING_MODEL ` | ` Xenova/bge-small-en-v1.5 ` | Local embedding model override |
159- | ` CODEBASE_CONTEXT_HTTP ` | — | Set to ` 1 ` to start in HTTP mode (same as ` --http ` flag) |
160- | ` CODEBASE_CONTEXT_PORT ` | ` 3100 ` | HTTP server port override (same as ` --port ` ; ignored in stdio mode) |
161- | ` CODEBASE_CONTEXT_CONFIG_PATH ` | ` ~/.codebase-context/config.json ` | Override the server config file path |
152+ | Variable | Default | Description |
153+ | ------------------------------ | --------------------------------- | -------------------------------------------------------- ----------- |
154+ | ` EMBEDDING_PROVIDER ` | ` transformers ` | ` openai ` (fast, cloud) or ` transformers ` (local, private) |
155+ | ` OPENAI_API_KEY ` | — | Required only if using ` openai ` provider |
156+ | ` CODEBASE_ROOT ` | — | Bootstrap root for CLI and single-project MCP clients |
157+ | ` CODEBASE_CONTEXT_DEBUG ` | — | Set to ` 1 ` for verbose logging |
158+ | ` EMBEDDING_MODEL ` | ` Xenova/bge-small-en-v1.5 ` | Local embedding model override |
159+ | ` CODEBASE_CONTEXT_HTTP ` | — | Set to ` 1 ` to start in HTTP mode (same as ` --http ` flag) |
160+ | ` CODEBASE_CONTEXT_PORT ` | ` 3100 ` | HTTP server port override (same as ` --port ` ; ignored in stdio mode) |
161+ | ` CODEBASE_CONTEXT_CONFIG_PATH ` | ` ~/.codebase-context/config.json ` | Override the server config file path |
162162
163163## Performance
164164
@@ -217,4 +217,4 @@ These are the behaviors that make the most difference day-to-day. Copy, trim wha
217217
218218## License
219219
220- MIT
220+ Elastic-2.0
0 commit comments