codesearch-mcp 0.0.17-alpha → 0.0.17-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -26
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# codesearch-mcp
|
|
2
2
|
|
|
3
|
-
Semantic codebase search for
|
|
3
|
+
Semantic codebase search for AI agents. Indexes your local projects into a PostgreSQL vector database and exposes search via the Model Context Protocol (MCP).
|
|
4
4
|
|
|
5
|
-
Ask
|
|
5
|
+
Ask your AI agent things like *"where is the payment retry logic?"* or *"show me how auth tokens are validated"* — across all your projects at once.
|
|
6
6
|
|
|
7
7
|
> **Alpha** — works well locally, API may change before 1.0.
|
|
8
8
|
|
|
@@ -107,25 +107,6 @@ Pass `include_graph_context: true` to `search_codebase` to see direct imports an
|
|
|
107
107
|
|
|
108
108
|
Useful for immediately understanding a file's role in the dependency graph.
|
|
109
109
|
|
|
110
|
-
## Cross-encoder reranking
|
|
111
|
-
|
|
112
|
-
By default, results are ordered by cosine distance (vector similarity). Enable cross-encoder reranking to reorder candidates by semantic relevance — better for queries where the exact wording differs from how the code is written.
|
|
113
|
-
|
|
114
|
-
Requires Ollama ≥ 0.6 and a reranker model:
|
|
115
|
-
|
|
116
|
-
```bash
|
|
117
|
-
ollama pull qllama/bge-reranker-v2-m3
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
```bash
|
|
121
|
-
rag-config set reranker.enabled true
|
|
122
|
-
rag-config set reranker.model qllama/bge-reranker-v2-m3
|
|
123
|
-
# rag-config set reranker.url http://localhost:11434/api/rerank # default
|
|
124
|
-
# rag-config set reranker.overfetch 3 # fetch limit×3 candidates before reranking
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
When enabled, `search_codebase` fetches `limit × reranker.overfetch` vector candidates, then the cross-encoder reranks them and returns the top `limit`. Falls back gracefully to vector order if the reranker is unreachable.
|
|
128
|
-
|
|
129
110
|
## Excluding files
|
|
130
111
|
|
|
131
112
|
Create `.ragignore` in a project root — same syntax as `.gitignore`:
|
|
@@ -154,7 +135,14 @@ rag-config set logging.dir false
|
|
|
154
135
|
|
|
155
136
|
## Configuration
|
|
156
137
|
|
|
157
|
-
All set by `rag-setup`.
|
|
138
|
+
All set by `rag-setup`. Stored in `~/.config/codesearch-mcp/config.json`.
|
|
139
|
+
|
|
140
|
+
```bash
|
|
141
|
+
rag-config show # print current config (password redacted)
|
|
142
|
+
rag-config get <key> # print a single value
|
|
143
|
+
rag-config set <key> <value> # update a value
|
|
144
|
+
rag-config reset <key> # remove key (reverts to default)
|
|
145
|
+
```
|
|
158
146
|
|
|
159
147
|
| Key | Default | Description |
|
|
160
148
|
|-----|---------|-------------|
|
|
@@ -170,10 +158,6 @@ All set by `rag-setup`. Override individual keys with `rag-config set <key> <val
|
|
|
170
158
|
| `search.autoTranslate` | `false` | Translate non-English queries to English before embedding |
|
|
171
159
|
| `search.translateModel` | `llama3.2` | Ollama model for translation (requires `ollama pull llama3.2`) |
|
|
172
160
|
| `indexing.astBatchSize` | `3000` | Max files per ts-morph batch — lower if indexing large projects causes OOM |
|
|
173
|
-
| `reranker.enabled` | `false` | Enable cross-encoder reranking (requires Ollama ≥ 0.6 and `reranker.model`) |
|
|
174
|
-
| `reranker.model` | — | Reranker model name (e.g. `qllama/bge-reranker-v2-m3`) |
|
|
175
|
-
| `reranker.url` | `${ollama.host}/api/rerank` | Override rerank endpoint URL |
|
|
176
|
-
| `reranker.overfetch` | `3` | Candidate multiplier before reranking (`limit × N`, max 20) |
|
|
177
161
|
| `logging.level` | `error` | Log level written to file: `error` \| `warn` \| `info` \| `debug` |
|
|
178
162
|
| `logging.dir` | `~/.config/codesearch-mcp/logs` | Base log directory, or `"false"` to disable |
|
|
179
163
|
|
package/package.json
CHANGED