@cachly-dev/mcp-server 0.5.43 → 0.5.45
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/CHANGELOG.md +97 -0
- package/Dockerfile +12 -15
- package/README.md +173 -145
- package/dist/__tests__/namespace.test.d.ts +1 -0
- package/dist/__tests__/namespace.test.js +114 -0
- package/dist/__tests__/namespace.test.js.map +1 -0
- package/dist/index.d.ts +31 -3
- package/dist/index.js +2641 -919
- package/dist/index.js.map +1 -1
- package/dist/search.test.js +173 -3
- package/dist/search.test.js.map +1 -1
- package/package.json +2 -2
- package/scripts/postinstall.js +36 -0
- package/smithery.yaml +10 -5
- package/src/__tests__/namespace.test.ts +126 -0
- package/src/index.ts +2731 -910
- package/src/search.test.ts +217 -3
- package/test-features.cjs +23 -0
- package/.github/workflows/publish.yml +0 -28
- package/LICENSE +0 -202
- package/glama.json +0 -6
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
# Changelog – cachly SDK (mcp)
|
|
2
|
+
|
|
3
|
+
**Language:** MCP (Model Context Protocol)
|
|
4
|
+
**Package:** `@cachly-dev/mcp-server` on **npm**
|
|
5
|
+
|
|
6
|
+
> Full cross-SDK release notes: [../CHANGELOG.md](../CHANGELOG.md)
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## [0.5.37] – 2026-04-24
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- **RTL language support (Arabic, Hebrew)** — word-level tokenization with Unicode ranges U+0590–U+05FF (Hebrew) and U+0600–U+06FF (Arabic); Arabic light stemmer strips definite article `ال` and single-char prefix particles (`و`,`ب`,`ل`,`ف`,`ك`)
|
|
15
|
+
- **Arabic and Hebrew stopwords** — ~60 high-frequency function words per language added to the STOPWORDS set
|
|
16
|
+
- **Romanization matching** — katakana segments now additionally emit Hepburn romaji tokens at index time (e.g. `デプロイ` → `depuroi`), so users can query Japanese docs using romaji
|
|
17
|
+
- **Full katakana→romaji converter** — handles digraphs (シャ→sha, チェ→che, ファ→fa), voiced consonants, geminate consonants (ッ), long vowel marks (ー), and loanword combinations
|
|
18
|
+
- **Cross-language retrieval** — 130+ tech term synonyms spanning EN↔JA↔ZH↔KO↔AR↔HE; searching `deploy` now finds docs containing `デプロイ`, `部署`, `배포` and vice versa; applies bidirectionally at tokenize time (zero runtime overhead)
|
|
19
|
+
- **73 unit tests** all passing — new test suites for `katakanaToRomaji`, `arabicLightStem`, `expandCrossLingual`, RTL tokenization, and cross-lingual expansion
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## [0.5.36] – 2026-04-22
|
|
24
|
+
|
|
25
|
+
### Added
|
|
26
|
+
|
|
27
|
+
- **Roadmap tools** — `roadmap_add`, `roadmap_update`, `roadmap_list`, `roadmap_next` for persistent project planning inside the Brain
|
|
28
|
+
- `session_start` now shows open roadmap items automatically
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## [0.5.35] – 2026-04-20
|
|
33
|
+
|
|
34
|
+
### Added
|
|
35
|
+
|
|
36
|
+
- **CJK language support** — Chinese (Simplified + Traditional), Japanese, Korean
|
|
37
|
+
- Character bigram extraction for CJK Unicode ranges
|
|
38
|
+
- ~140 CJK stopwords (Chinese particles, Japanese hiragana particles, Korean postpositions)
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
### Added
|
|
45
|
+
|
|
46
|
+
- **`setup` command** — interactive zero-arg CLI wizard (`npx @cachly-dev/mcp-server setup`):
|
|
47
|
+
- Reads `CACHLY_JWT` from env or prompts interactively via readline
|
|
48
|
+
- Fetches instances from API; presents list when multiple exist
|
|
49
|
+
- Auto-detects installed editors (Cursor, Windsurf, VS Code, Continue.dev) by checking for their config directories
|
|
50
|
+
- Writes the correct MCP config file for each detected editor in one step
|
|
51
|
+
- Always writes/updates `CLAUDE.md` (idempotent via `<!-- cachly-brain-start/end -->` markers)
|
|
52
|
+
- **`init` command** now idempotent — re-running `npx @cachly-dev/mcp-server init` updates the brain block in `CLAUDE.md` instead of appending a duplicate
|
|
53
|
+
- Shared helpers: `buildMcpConfig()`, `buildClaudeMdBlock()`, `writeClaudeMd()` — used by both `setup` and `init`
|
|
54
|
+
|
|
55
|
+
### Fixed
|
|
56
|
+
|
|
57
|
+
- `init` no longer duplicates the brain block in `CLAUDE.md` when run multiple times
|
|
58
|
+
- Correct package name `@cachly-dev/mcp-server` used consistently (was `@cachly-dev/mcp` in generated configs)
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## [0.1.1] – 2026-04-07
|
|
63
|
+
|
|
64
|
+
### Fixed
|
|
65
|
+
|
|
66
|
+
- Broken `index_project` tool schema – properties were accidentally placed outside the `TOOLS` array
|
|
67
|
+
- Unused `openai` variable removed from `cache_warmup` handler
|
|
68
|
+
- `readdir` type mismatch (`Dirent<string>` vs. `NonSharedBuffer`) fixed
|
|
69
|
+
- Version bumped to `0.3.0` in server metadata
|
|
70
|
+
|
|
71
|
+
---
|
|
72
|
+
|
|
73
|
+
## [0.1.0] – 2026-04-07
|
|
74
|
+
|
|
75
|
+
Initial release.
|
|
76
|
+
|
|
77
|
+
### Added
|
|
78
|
+
|
|
79
|
+
- MCP tool: `cache_set` – store a value with optional TTL
|
|
80
|
+
- MCP tool: `cache_get` – retrieve a cached value
|
|
81
|
+
- MCP tool: `cache_delete` – remove a key
|
|
82
|
+
- MCP tool: `semantic_search` – vector-similarity lookup for LLM response caching
|
|
83
|
+
- MCP tool: `cache_clear` – flush namespace or entire cache
|
|
84
|
+
- Compatible with Claude Desktop, Cursor, Windsurf, and any MCP-capable host
|
|
85
|
+
- API-key-based authentication
|
|
86
|
+
- EU data residency (German servers, DSGVO compliant)
|
|
87
|
+
|
|
88
|
+
### Known limitations
|
|
89
|
+
|
|
90
|
+
- ~~Streaming tools not yet supported~~ (tracked for a future release)
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## [Unreleased]
|
|
95
|
+
|
|
96
|
+
See [../CHANGELOG.md](../CHANGELOG.md) for upcoming features.
|
|
97
|
+
|
package/Dockerfile
CHANGED
|
@@ -1,19 +1,16 @@
|
|
|
1
|
-
FROM node:22-alpine
|
|
1
|
+
FROM node:22-alpine AS builder
|
|
2
2
|
WORKDIR /app
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
COPY package*.json ./
|
|
6
|
-
RUN npm ci
|
|
7
|
-
|
|
8
|
-
# Build TypeScript
|
|
3
|
+
COPY package*.json tsconfig*.json ./
|
|
4
|
+
RUN npm ci --ignore-scripts
|
|
9
5
|
COPY src/ ./src/
|
|
10
|
-
|
|
11
|
-
RUN npm run build && npm prune --omit=dev
|
|
12
|
-
|
|
13
|
-
# MCP servers communicate over stdio — no port needed
|
|
14
|
-
ENV CACHLY_JWT=""
|
|
15
|
-
ENV CACHLY_INSTANCE_ID=""
|
|
16
|
-
ENV CACHLY_NO_TELEMETRY=1
|
|
17
|
-
ENV CACHLY_NO_UPDATE_CHECK=1
|
|
6
|
+
RUN npm run build
|
|
18
7
|
|
|
8
|
+
FROM node:22-alpine
|
|
9
|
+
WORKDIR /app
|
|
10
|
+
COPY package*.json ./
|
|
11
|
+
RUN npm ci --omit=dev --ignore-scripts
|
|
12
|
+
COPY --from=builder /app/dist/ ./dist/
|
|
13
|
+
ENV NODE_ENV=production
|
|
14
|
+
ENV PORT=3000
|
|
15
|
+
EXPOSE 3000
|
|
19
16
|
ENTRYPOINT ["node", "dist/index.js"]
|
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
# cachly
|
|
1
|
+
# 🧠 cachly AI Brain — MCP Server
|
|
2
2
|
|
|
3
|
-
> **Claude
|
|
4
|
-
>
|
|
3
|
+
> **Persistent memory for Claude Code, Cursor, GitHub Copilot, Windsurf, Cline & Zed.**
|
|
4
|
+
> Your AI remembers every lesson, every fix, every architecture decision — forever.
|
|
5
5
|
|
|
6
6
|
<p align="center">
|
|
7
|
-
<a href="https://github.com/cachly-dev/
|
|
8
|
-
<img src="https://img.shields.io/github/stars/cachly-dev/
|
|
7
|
+
<a href="https://github.com/cachly-dev/mcp-server/stargazers">
|
|
8
|
+
<img src="https://img.shields.io/github/stars/cachly-dev/mcp-server?style=social" alt="GitHub Stars" />
|
|
9
9
|
</a>
|
|
10
10
|
|
|
11
11
|
<a href="https://www.npmjs.com/package/@cachly-dev/mcp-server">
|
|
@@ -23,123 +23,204 @@
|
|
|
23
23
|
<a href="https://cachly.dev/legal">
|
|
24
24
|
<img src="https://img.shields.io/badge/GDPR-EU%20only-green" alt="GDPR: EU only" />
|
|
25
25
|
</a>
|
|
26
|
+
|
|
27
|
+
<img src="https://img.shields.io/badge/License-Apache--2.0-yellow" alt="License: Apache-2.0" />
|
|
26
28
|
</p>
|
|
27
29
|
|
|
28
30
|
---
|
|
29
31
|
|
|
30
|
-
##
|
|
32
|
+
## The Problem
|
|
33
|
+
|
|
34
|
+
Every morning, you open your AI coding assistant. It doesn't remember yesterday.
|
|
35
|
+
You explain your architecture. You explain the deployment process. You explain the bug you fixed last week.
|
|
36
|
+
|
|
37
|
+
**The average developer wastes 45 minutes/day re-establishing context.** That's €15,000+ in lost productivity per engineer per year.
|
|
38
|
+
|
|
39
|
+
## The Fix — One Command
|
|
31
40
|
|
|
32
41
|
```bash
|
|
33
42
|
npx @cachly-dev/mcp-server@latest setup
|
|
34
43
|
```
|
|
35
44
|
|
|
36
|
-
|
|
37
|
-
|
|
45
|
+
The interactive wizard:
|
|
46
|
+
1. Signs you in (free, no credit card required)
|
|
47
|
+
2. Picks or creates your AI Brain instance
|
|
48
|
+
3. **Auto-detects** Cursor, Windsurf, VS Code, Claude Code, Continue.dev, **Cline & Zed**
|
|
49
|
+
4. Writes the correct MCP config for every detected editor
|
|
50
|
+
5. Creates `CLAUDE.md` with memory rules pre-filled
|
|
51
|
+
6. Shows your Brain Health snapshot right in the terminal
|
|
52
|
+
|
|
53
|
+
**Index your project** into the Brain for instant semantic search:
|
|
54
|
+
```bash
|
|
55
|
+
npx @cachly-dev/mcp-server@latest index .
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
**Result:** Your AI remembers everything. Always.
|
|
38
59
|
|
|
39
60
|
---
|
|
40
61
|
|
|
41
|
-
##
|
|
62
|
+
## Quick Start (Manual)
|
|
42
63
|
|
|
43
|
-
|
|
64
|
+
**Step 1 — Get your free credentials** at [cachly.dev](https://cachly.dev) (25 MB free, forever, no credit card).
|
|
44
65
|
|
|
45
|
-
|
|
46
|
-
🧠 Session Briefing
|
|
66
|
+
**Step 2 — Add to your editor's MCP config:**
|
|
47
67
|
|
|
48
|
-
|
|
49
|
-
|
|
68
|
+
<details>
|
|
69
|
+
<summary><b>Claude Code</b> (<code>~/.claude/mcp.json</code> or <code>.mcp.json</code>)</summary>
|
|
50
70
|
|
|
51
|
-
|
|
71
|
+
```json
|
|
72
|
+
{
|
|
73
|
+
"mcpServers": {
|
|
74
|
+
"cachly": {
|
|
75
|
+
"type": "stdio",
|
|
76
|
+
"command": "npx",
|
|
77
|
+
"args": ["-y", "@cachly-dev/mcp-server@latest"],
|
|
78
|
+
"env": {
|
|
79
|
+
"CACHLY_JWT": "your-jwt-token",
|
|
80
|
+
"CACHLY_INSTANCE_ID": "your-instance-id"
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
```
|
|
86
|
+
</details>
|
|
52
87
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
✅ keycloak:refresh-token — use httpOnly cookie, not localStorage — Safari blocks third-party
|
|
56
|
-
❌ oauth:pkce — PKCE + CORS broken in Safari 16.3, still unresolved
|
|
88
|
+
<details>
|
|
89
|
+
<summary><b>Cursor / Windsurf / VS Code</b> (<code>.cursor/mcp.json</code> / <code>.mcp.json</code>)</summary>
|
|
57
90
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
91
|
+
```json
|
|
92
|
+
{
|
|
93
|
+
"servers": {
|
|
94
|
+
"cachly": {
|
|
95
|
+
"type": "stdio",
|
|
96
|
+
"command": "npx",
|
|
97
|
+
"args": ["-y", "@cachly-dev/mcp-server@latest"],
|
|
98
|
+
"env": {
|
|
99
|
+
"CACHLY_JWT": "your-jwt-token",
|
|
100
|
+
"CACHLY_INSTANCE_ID": "your-instance-id"
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
}
|
|
62
105
|
```
|
|
106
|
+
</details>
|
|
63
107
|
|
|
64
|
-
|
|
65
|
-
|
|
108
|
+
**Step 3 — Add to `CLAUDE.md` / `.github/copilot-instructions.md`:**
|
|
109
|
+
|
|
110
|
+
```markdown
|
|
111
|
+
## AI Brain Rules (cachly)
|
|
112
|
+
- Call session_start BEFORE reading any files or making changes
|
|
113
|
+
- Call learn_from_attempts AFTER every fix, deploy, or discovery
|
|
114
|
+
- Call session_end when closing the window
|
|
115
|
+
```
|
|
66
116
|
|
|
67
117
|
---
|
|
68
118
|
|
|
69
|
-
##
|
|
119
|
+
## With vs. Without cachly
|
|
70
120
|
|
|
71
121
|
| Situation | Without cachly | With cachly |
|
|
72
122
|
|-----------|----------------|-------------|
|
|
73
|
-
| Session start | "What's your architecture?" |
|
|
74
|
-
|
|
|
75
|
-
| After holiday | Context
|
|
76
|
-
|
|
|
77
|
-
|
|
|
123
|
+
| Session start | "What's your architecture?" | "Ready. 23 lessons, last session: deployed API." |
|
|
124
|
+
| Known bug hits again | Re-researches from scratch | "You fixed this on March 12, here's the exact command" |
|
|
125
|
+
| After holiday / team handoff | Context dead | Fully briefed in < 10 seconds |
|
|
126
|
+
| Repeated LLM patterns | Pays for each re-discovery | Cached by meaning, ~1,200 tokens saved per hit |
|
|
127
|
+
| New team member | Weeks to onboard | `session_start` gives full context instantly |
|
|
78
128
|
|
|
79
129
|
---
|
|
80
130
|
|
|
81
|
-
##
|
|
82
|
-
|
|
83
|
-
```
|
|
84
|
-
🧠 cachly AI Brain — Interactive Setup
|
|
85
|
-
────────────────────────────────────────
|
|
86
|
-
|
|
87
|
-
Step 1: Sign in to cachly (free — no credit card required)
|
|
88
|
-
Code: XKCD-9281
|
|
89
|
-
URL: https://auth.cachly.dev/activate?user_code=XKCD-9281
|
|
90
|
-
✓ Browser opened — confirm the code above to continue...
|
|
91
|
-
................. ✓ Authorized!
|
|
92
|
-
⏳ Generating your API key... ✓
|
|
131
|
+
## 51 MCP Tools
|
|
93
132
|
|
|
94
|
-
|
|
133
|
+
### 🧠 Session & Memory (most used)
|
|
95
134
|
|
|
96
|
-
|
|
135
|
+
| Tool | What it does |
|
|
136
|
+
|------|-------------|
|
|
137
|
+
| **`session_start`** | Full briefing: last session summary, open failures, recent lessons, brain health |
|
|
138
|
+
| **`session_end`** | Save what you built, auto-extract lessons from summary + ambient git log |
|
|
139
|
+
| **`session_handoff`** | Hand off remaining tasks to next window, with context |
|
|
140
|
+
| **`auto_learn_session`** | Batch-learn from a list of observations |
|
|
141
|
+
| **`sync_file_changes`** | Sync changed files into brain index |
|
|
142
|
+
| **`learn_from_attempts`** | Store structured lessons after any fix, deploy, or discovery |
|
|
143
|
+
| **`recall_best_solution`** | Best known solution for a topic — with success/failure history |
|
|
144
|
+
| **`recall_at`** | Recall a lesson at a specific point in time |
|
|
145
|
+
| **`remember_context`** | Cache architecture findings, decisions, file summaries |
|
|
146
|
+
| **`recall_context`** | Get exact context by key (supports glob) |
|
|
147
|
+
| **`list_remembered`** | See all cached context entries |
|
|
148
|
+
| **`forget_context`** | Remove stale context |
|
|
149
|
+
| **`smart_recall`** | BM25+ full-text search across all brain data — multilingual: EN, DE, FR, ES, IT, PT, ZH, JA, KO, **AR, HE** |
|
|
150
|
+
| **`setup_ai_memory`** | Interactive wizard to configure AI memory |
|
|
151
|
+
|
|
152
|
+
### 🌍 Multilingual Brain — Search in Any Language
|
|
153
|
+
|
|
154
|
+
The Brain's search engine understands **11 languages natively** — no configuration required.
|
|
155
|
+
|
|
156
|
+
| Script | Languages | Tokenization |
|
|
157
|
+
|--------|-----------|-------------|
|
|
158
|
+
| Latin | EN, DE, FR, ES, IT, PT | Whitespace + stopwords |
|
|
159
|
+
| CJK | Chinese (ZH), Japanese (JA), Korean (KO) | Character bigrams |
|
|
160
|
+
| RTL | Arabic (AR), Hebrew (HE) | Word tokenization + light stemming |
|
|
161
|
+
|
|
162
|
+
**Romanization matching** — store lessons in Japanese, search in romaji:
|
|
163
|
+
```
|
|
164
|
+
smart_recall("kontena") → finds コンテナ docs
|
|
165
|
+
smart_recall("depuroi") → finds デプロイ docs
|
|
166
|
+
```
|
|
97
167
|
|
|
98
|
-
|
|
99
|
-
|
|
168
|
+
**Cross-language retrieval** — 130+ tech term synonyms EN↔JA↔ZH↔KO↔AR↔HE:
|
|
169
|
+
```
|
|
170
|
+
smart_recall("deploy") → finds デプロイ, 部署, 배포, نشر, פריסה
|
|
171
|
+
smart_recall("デプロイ") → finds "deploy", "deployment"
|
|
172
|
+
smart_recall("خطأ") → finds "error", エラー, 错误
|
|
173
|
+
```
|
|
100
174
|
|
|
101
|
-
|
|
102
|
-
✅ Written: .cursor/mcp.json
|
|
103
|
-
✅ Written: CLAUDE.md
|
|
175
|
+
### 💡 Legendary Brain Features
|
|
104
176
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
177
|
+
| Feature | How it works |
|
|
178
|
+
|---------|-------------|
|
|
179
|
+
| **Team Telepathy** | Multi-dev Brain: the `author` param on `learn_from_attempts` shares fixes across the whole team. Every `session_start` shows colleagues' lessons. |
|
|
180
|
+
| **Ambient Git Learning** | Pass `workspace_path` to `session_end` — it auto-reads `git log`, stores recent commits as Brain lessons. Zero extra calls. |
|
|
181
|
+
| **Memory Crystals** | `memory_crystalize` distills all lessons into a compact Crystal injected at every `session_start`. AI arrives pre-loaded with team knowledge. |
|
|
182
|
+
| **IQ Boost** | `brain_doctor` reports `iq_boost_pct` — how much smarter your AI gets vs. baseline from cached lessons. |
|
|
108
183
|
|
|
109
|
-
|
|
184
|
+
### ⚙️ Instance Management
|
|
110
185
|
|
|
111
|
-
|
|
186
|
+
| Tool | What it does |
|
|
187
|
+
|------|-------------|
|
|
188
|
+
| `list_instances` | List all your cache instances |
|
|
189
|
+
| `create_instance` | Spin up a new instance (free or paid) |
|
|
190
|
+
| `get_connection_string` | Get the `redis://` URL for your app |
|
|
191
|
+
| `delete_instance` | Remove an instance |
|
|
192
|
+
| `get_real_time_stats` | Memory, hit rate, ops/sec |
|
|
112
193
|
|
|
113
|
-
###
|
|
194
|
+
### 🗄️ Cache Operations
|
|
114
195
|
|
|
115
196
|
| Tool | What it does |
|
|
116
197
|
|------|-------------|
|
|
117
|
-
|
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
121
|
-
| **`smart_recall`** | Full-text search across all brain data (BM25+) |
|
|
122
|
-
| **`remember_context`** / **`recall_context`** | Save/restore architecture findings, file summaries, ADRs |
|
|
123
|
-
| **`forget_lesson`** | Remove a stale or wrong lesson |
|
|
124
|
-
| **`list_lessons`** | Overview of all stored topics with severity, age, recall count |
|
|
198
|
+
| `cache_get` / `cache_set` / `cache_delete` | Standard cache operations |
|
|
199
|
+
| `cache_mget` / `cache_mset` | Bulk pipeline (single round-trip) |
|
|
200
|
+
| `cache_lock_acquire` / `cache_lock_release` | Distributed Redlock-lite |
|
|
201
|
+
| `cache_stream_set` / `cache_stream_get` | LLM token stream caching |
|
|
125
202
|
|
|
126
|
-
###
|
|
203
|
+
### 🔍 Semantic Cache
|
|
127
204
|
|
|
128
205
|
| Tool | What it does |
|
|
129
206
|
|------|-------------|
|
|
130
|
-
|
|
|
131
|
-
|
|
|
132
|
-
|
|
|
133
|
-
| **`invite_member`** | Invite a dev to your org by email |
|
|
207
|
+
| `semantic_search` | Find cached entries by meaning (pgvector HNSW, EU-hosted) |
|
|
208
|
+
| `semantic_warmup` | Pre-warm cache with prompt/response pairs |
|
|
209
|
+
| `detect_namespace` | Auto-classify prompt into code/qa/summary/translation/creative |
|
|
134
210
|
|
|
135
|
-
###
|
|
211
|
+
### 👥 Team Brain
|
|
136
212
|
|
|
137
213
|
| Tool | What it does |
|
|
138
214
|
|------|-------------|
|
|
139
|
-
| `
|
|
140
|
-
| `
|
|
141
|
-
| `
|
|
142
|
-
| `
|
|
215
|
+
| `team_learn` / `team_recall` | Share lessons across the team |
|
|
216
|
+
| `team_synthesize` | Consolidate multiple lessons into one authoritative version |
|
|
217
|
+
| `memory_crystalize` | Distill all lessons into a Crystal snapshot for instant team context |
|
|
218
|
+
| `brain_doctor` | Health check: lesson count, IQ boost %, open failures, quality score |
|
|
219
|
+
| `global_learn` / `global_recall` | Cross-project universal lessons |
|
|
220
|
+
| `publish_lesson` / `import_public_brain` | Share/import community knowledge |
|
|
221
|
+
| `trace_dependency` | Causal chain — find lessons affected by a dependency change |
|
|
222
|
+
| `list_orgs` / `create_org` | Manage team organizations |
|
|
223
|
+
| `invite_member` / `get_org_plan` | Invite a developer to your org by email |
|
|
143
224
|
|
|
144
225
|
---
|
|
145
226
|
|
|
@@ -147,69 +228,13 @@ Step 3: Detected editors: Claude Code, Cursor, GitHub Copilot
|
|
|
147
228
|
|
|
148
229
|
| Tier | RAM | Price | Best for |
|
|
149
230
|
|------|-----|-------|----------|
|
|
150
|
-
| **Free** | 25 MB | **€0/mo forever** |
|
|
231
|
+
| **Free** | 25 MB | **€0/mo forever** | Dev & side projects |
|
|
151
232
|
| **Dev** | 200 MB | €19/mo | Individual developers |
|
|
152
|
-
| **Pro** | 900 MB | €49/mo | Teams
|
|
153
|
-
| **Speed** | 900 MB + Dragonfly + Semantic | €79/mo | AI-heavy workloads |
|
|
233
|
+
| **Pro** | 900 MB | €49/mo | Teams |
|
|
234
|
+
| **Speed** | 900 MB + Dragonfly + Semantic Cache | €79/mo | AI-heavy workloads |
|
|
154
235
|
| **Business** | 7 GB | €199/mo | Scale-ups |
|
|
155
236
|
|
|
156
|
-
✅ All plans: **German servers · GDPR-compliant · 99.9% SLA ·
|
|
157
|
-
|
|
158
|
-
---
|
|
159
|
-
|
|
160
|
-
## Manual setup (if you prefer)
|
|
161
|
-
|
|
162
|
-
<details>
|
|
163
|
-
<summary>Claude Code (<code>~/.claude/mcp.json</code> or <code>.mcp.json</code>)</summary>
|
|
164
|
-
|
|
165
|
-
```json
|
|
166
|
-
{
|
|
167
|
-
"mcpServers": {
|
|
168
|
-
"cachly": {
|
|
169
|
-
"type": "stdio",
|
|
170
|
-
"command": "npx",
|
|
171
|
-
"args": ["-y", "@cachly-dev/mcp-server@latest"],
|
|
172
|
-
"env": {
|
|
173
|
-
"CACHLY_JWT": "your-api-key",
|
|
174
|
-
"CACHLY_BRAIN_INSTANCE_ID": "your-instance-id"
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
|
-
}
|
|
178
|
-
}
|
|
179
|
-
```
|
|
180
|
-
</details>
|
|
181
|
-
|
|
182
|
-
<details>
|
|
183
|
-
<summary>Cursor / Windsurf (<code>.cursor/mcp.json</code> or <code>.mcp.json</code>)</summary>
|
|
184
|
-
|
|
185
|
-
```json
|
|
186
|
-
{
|
|
187
|
-
"servers": {
|
|
188
|
-
"cachly": {
|
|
189
|
-
"type": "stdio",
|
|
190
|
-
"command": "npx",
|
|
191
|
-
"args": ["-y", "@cachly-dev/mcp-server@latest"],
|
|
192
|
-
"env": {
|
|
193
|
-
"CACHLY_JWT": "your-api-key",
|
|
194
|
-
"CACHLY_BRAIN_INSTANCE_ID": "your-instance-id"
|
|
195
|
-
}
|
|
196
|
-
}
|
|
197
|
-
}
|
|
198
|
-
}
|
|
199
|
-
```
|
|
200
|
-
</details>
|
|
201
|
-
|
|
202
|
-
<details>
|
|
203
|
-
<summary>CLAUDE.md brain rules</summary>
|
|
204
|
-
|
|
205
|
-
```markdown
|
|
206
|
-
## AI Brain (cachly)
|
|
207
|
-
- ALWAYS call `session_start` at the beginning of every session — no exceptions
|
|
208
|
-
- After every fix, deploy, or discovery: call `learn_from_attempts`
|
|
209
|
-
- Before working on a known topic: call `recall_best_solution("<topic>")`
|
|
210
|
-
- At session end: call `session_end` with a one-line summary
|
|
211
|
-
```
|
|
212
|
-
</details>
|
|
237
|
+
✅ All plans: **German servers · GDPR-compliant · 99.9% SLA · No credit card for Free tier**
|
|
213
238
|
|
|
214
239
|
---
|
|
215
240
|
|
|
@@ -217,27 +242,30 @@ Step 3: Detected editors: Claude Code, Cursor, GitHub Copilot
|
|
|
217
242
|
|
|
218
243
|
| Variable | Default | Description |
|
|
219
244
|
|----------|---------|-------------|
|
|
220
|
-
| `CACHLY_JWT` | — | **Required.** API
|
|
221
|
-
| `
|
|
245
|
+
| `CACHLY_JWT` | — | **Required.** Your API token from [cachly.dev](https://cachly.dev) |
|
|
246
|
+
| `CACHLY_INSTANCE_ID` | — | Default instance UUID (optional if you pass per-call) |
|
|
222
247
|
| `CACHLY_API_URL` | `https://api.cachly.dev` | Override for self-hosted |
|
|
223
|
-
| `CACHLY_NO_TELEMETRY` | unset | Set to `1` to
|
|
248
|
+
| `CACHLY_NO_TELEMETRY` | unset | Set to `1` to disable anonymous usage pings |
|
|
249
|
+
| `CACHLY_NO_UPDATE_CHECK` | unset | Set to `1` to disable the version-check on startup |
|
|
224
250
|
|
|
225
251
|
---
|
|
226
252
|
|
|
227
|
-
## Ecosystem
|
|
253
|
+
## 🛠️ Ecosystem
|
|
228
254
|
|
|
229
255
|
| Package | What it does |
|
|
230
256
|
|---------|-------------|
|
|
231
|
-
| **[`@cachly-dev/mcp-server`](https://www.npmjs.com/package/@cachly-dev/mcp-server)** | ← you are here — AI Brain MCP for Claude Code, Cursor, Copilot, Windsurf |
|
|
232
|
-
| **[
|
|
233
|
-
| **[`@cachly-dev/
|
|
234
|
-
| **[`@cachly-dev/
|
|
257
|
+
| **[`@cachly-dev/mcp-server`](https://www.npmjs.com/package/@cachly-dev/mcp-server)** | ← you are here — AI Brain MCP tools for Claude Code, Cursor, Copilot, Windsurf |
|
|
258
|
+
| **[`@cachly-dev/openclaw`](https://www.npmjs.com/package/@cachly-dev/openclaw)** | JS/TS SDK — cut LLM costs 60–90% with semantic cache + BM25 in your own app, 3 lines of code |
|
|
259
|
+
| **[`@cachly-dev/init`](https://www.npmjs.com/package/@cachly-dev/init)** | One-command setup wizard: auto-detects all your editors and writes the correct MCP config — `npx @cachly-dev/init` |
|
|
260
|
+
| **[`@cachly-dev/cli`](https://www.npmjs.com/package/@cachly-dev/cli)** | Terminal CLI — manage instances, cache data, brain lessons: `npm i -g @cachly-dev/cli` |
|
|
261
|
+
| **[`@cachly-dev/sdk`](https://www.npmjs.com/package/@cachly-dev/sdk)** | Node.js/TypeScript SDK — use managed Redis, semantic cache & AI memory directly in your app |
|
|
235
262
|
|
|
236
263
|
---
|
|
237
264
|
|
|
238
265
|
## Links
|
|
239
266
|
|
|
240
267
|
- 🌐 [cachly.dev](https://cachly.dev) — Dashboard & free signup
|
|
241
|
-
- 📖 [
|
|
242
|
-
- 💬 [Issues](https://github.com/cachly-dev/
|
|
243
|
-
- ⭐ [Star on GitHub](https://github.com/cachly-dev/
|
|
268
|
+
- 📖 [AI Brain docs](https://cachly.dev/docs/ai-memory) — Full documentation
|
|
269
|
+
- 💬 [GitHub Issues](https://github.com/cachly-dev/mcp-server/issues) — Bug reports & feature requests
|
|
270
|
+
- ⭐ [Star on GitHub](https://github.com/cachly-dev/mcp-server) — If cachly saves you time, a star means a lot!
|
|
271
|
+
- 📦 [npm](https://www.npmjs.com/package/@cachly-dev/mcp-server)
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|