@cachly-dev/mcp-server 0.10.44 โ†’ 0.10.46

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 CHANGED
@@ -1,7 +1,7 @@
1
1
  # ๐Ÿง  cachly AI Brain โ€” MCP Server
2
2
 
3
- > **You're a senior developer. Your AI should act like one.**
4
- > Stop re-teaching your AI every morning. cachly gives it a permanent brain โ€” pre-briefed every session, learns from every commit, never makes the same mistake twice.
3
+ > **Your AI forgets everything between sessions. cachly fixes that.**
4
+ > Stop re-teaching your stack every morning. cachly gives your AI a permanent brain โ€” pre-briefed every session, learns from every commit, never makes the same mistake twice. Works whether you write 10 lines or 10,000.
5
5
 
6
6
  <p align="center">
7
7
  <a href="https://www.npmjs.com/package/@cachly-dev/mcp-server">
@@ -20,14 +20,10 @@
20
20
  <img src="https://img.shields.io/badge/GDPR-EU%20servers-green" alt="GDPR: EU servers" />
21
21
  </a>
22
22
  &nbsp;
23
- <img src="https://img.shields.io/badge/84%20MCP%20tools-violet" alt="84 MCP tools" />
23
+ <img src="https://img.shields.io/badge/80%20MCP%20tools-violet" alt="80 MCP tools" />
24
24
  &nbsp;
25
25
  <img src="https://img.shields.io/badge/License-Apache--2.0-yellow" alt="License: Apache-2.0" />
26
26
  &nbsp;
27
- <a href="https://smithery.ai/server/@cachly-dev/mcp-server">
28
- <img src="https://smithery.ai/badge/@cachly-dev/mcp-server" alt="Smithery" />
29
- </a>
30
- &nbsp;
31
27
  <a href="https://cachly.dev">
32
28
  <img src="https://img.shields.io/badge/Brain%20badge-embed%20in%20README-7c3aed" alt="Brain badge" />
33
29
  </a>
@@ -41,33 +37,33 @@
41
37
  npx @cachly-dev/mcp-server@latest demo
42
38
  ```
43
39
 
44
- Run this in any project directory. It reads your git history and shows exactly what your AI would know:
40
+ Run it in any project folder. It scans your git history and shows a preview of what your AI would know โ€” YOUR bugs fixed, YOUR patterns, YOUR past decisions. No account needed.
45
41
 
46
42
  ```
47
43
  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
48
- โ”‚ ๐Ÿง  Brain Preview โ€” What your AI would know โ”‚
44
+ โ”‚ Brain Preview โ€” What your AI would know โ”‚
49
45
  โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
50
- โ”‚ Commits analysed : 847 Date range: 2024-01-12 โ†’ 2026-05-14 โ”‚
51
- โ”‚ Lessons extracted: 634 Contributors: 7 โ”‚
46
+ โ”‚ Commits: 847 Lessons: 634 Contributors: 7 โ”‚
47
+ โ”‚ Date range: 2024-01-12 โ†’ 2026-05-14 โ”‚
52
48
  โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
53
- โ”‚ Category breakdown: โ”‚
54
- โ”‚ ๐Ÿ”ง fix โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ 312 โ”‚
55
- โ”‚ โœจ feat โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ 189 โ”‚
56
- โ”‚ ๐Ÿ”’ security โ–ˆโ–ˆ 18 โ”‚
57
- โ”‚ ๐Ÿš€ deploy โ–ˆโ–ˆ 15 โ”‚
49
+ โ”‚ Category breakdown: โ”‚
50
+ โ”‚ fix โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ 312 โ”‚
51
+ โ”‚ feat โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ 189 โ”‚
52
+ โ”‚ security โ–ˆโ–ˆ 18 โ”‚
53
+ โ”‚ deploy โ–ˆโ–ˆ 15 โ”‚
58
54
  โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
59
- โ”‚ ๐Ÿ”’ Security fixes your AI would know: โ”‚
60
- โ”‚ โ€ข fix(auth): JWT expiry check before signature validation โ”‚
61
- โ”‚ โ€ข security: sanitize webhook payload before JSON.parse โ”‚
55
+ โ”‚ Security fixes your AI would know: โ”‚
56
+ โ”‚ โ€ข fix(auth): JWT expiry check before signature validation โ”‚
57
+ โ”‚ โ€ข security: sanitize webhook payload before JSON.parse โ”‚
62
58
  โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
63
- โ”‚ ๐Ÿ”ง Bug fixes your AI would remember: โ”‚
64
- โ”‚ โ€ข fix: Redis pub/sub race condition under high concurrency โ”‚
65
- โ”‚ โ€ข fix: k8s readinessProbe threshold too low for cold start โ”‚
66
- โ”‚ โ€ข fix: Stripe idempotency_key missing on retry path โ”‚
67
- โ”‚ โ€ข fix: tRPC context not forwarded to background jobs โ”‚
59
+ โ”‚ Bug fixes your AI would remember: โ”‚
60
+ โ”‚ โ€ข fix: Redis pub/sub race condition under high concurrency โ”‚
61
+ โ”‚ โ€ข fix: k8s readinessProbe threshold too low for cold start โ”‚
62
+ โ”‚ โ€ข fix: Stripe idempotency_key missing on retry path โ”‚
63
+ โ”‚ โ€ข fix: tRPC context not forwarded to background jobs โ”‚
68
64
  โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
69
- โ”‚ ๐Ÿ’ก With cachly, your AI arrives pre-briefed every session. โ”‚
70
- โ”‚ No more re-explaining. No more repeated mistakes. โ”‚
65
+ โ”‚ With cachly, your AI arrives pre-briefed every session. โ”‚
66
+ โ”‚ No more re-explaining. No more repeated mistakes. โ”‚
71
67
  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
72
68
 
73
69
  Make this permanent (free, 1โ€“5 minutes):
@@ -79,6 +75,24 @@ Run this in any project directory. It reads your git history and shows exactly w
79
75
 
80
76
  ---
81
77
 
78
+ ## Already in Claude / Cursor / Copilot? Just paste this
79
+
80
+ Skip the setup guide โ€” copy the prompt below and paste it directly into your AI. It will run the command and configure everything automatically:
81
+
82
+ ```
83
+ Set up cachly for this project. Run this in the terminal:
84
+ npx @cachly-dev/mcp-server@latest setup
85
+
86
+ It gives you persistent memory across sessions โ€” your AI recalls past
87
+ decisions, avoids repeated bugs, and arrives briefed every time you
88
+ open it. Follow the browser login (one click, no credit card), then
89
+ restart your editor. Free forever.
90
+ ```
91
+
92
+ Your AI will execute the command, detect your editors, write the config, and brief itself on your project.
93
+
94
+ ---
95
+
82
96
  ## The Problem
83
97
 
84
98
  Every morning, you open your AI coding assistant. It doesn't remember yesterday.
@@ -153,45 +167,6 @@ npx @cachly-dev/mcp-server@latest learn-git # Auto-learn lessons from recent git
153
167
 
154
168
  ---
155
169
 
156
- ## Read your Brain from anything โ€” REST API (no MCP required)
157
-
158
- MCP is the easiest path, but any agent, robot, script, or service can read the
159
- Brain over plain HTTP. No Node.js, no MCP client โ€” just your instance token.
160
-
161
- **Search the Brain (BM25+ keyword search):**
162
-
163
- ```bash
164
- curl -s -X POST "https://api.cachly.dev/v1/cache/$CACHLY_TOKEN/brain-search" \
165
- -H "Content-Type: application/json" \
166
- -d '{"query": "redis connection timeout", "top_k": 5}'
167
- ```
168
-
169
- Returns ranked matches with previews:
170
-
171
- ```json
172
- {
173
- "results": [
174
- { "key": "lesson:best:redis:pool", "score": 8.4,
175
- "matched_words": ["redis", "timeout"],
176
- "preview": "set max_retries=3 + ConnMaxLifetime=30m; ..." }
177
- ],
178
- "total_docs": 142,
179
- "duration_ms": 6
180
- }
181
- ```
182
-
183
- **Get Brain stats:**
184
-
185
- ```bash
186
- curl -s "https://api.cachly.dev/v1/cache/$CACHLY_TOKEN/brain-stats"
187
- ```
188
-
189
- `$CACHLY_TOKEN` is your instance token (`cky_live_โ€ฆ`) โ€” the same one the setup
190
- wizard writes into your editor config. This is all a non-MCP agent needs to
191
- arrive pre-briefed.
192
-
193
- ---
194
-
195
170
  ## Brain Badge โ€” show your lessons live
196
171
 
197
172
  Add a live lesson-count badge to any README โ€” updates every hour, no auth required:
@@ -252,7 +227,7 @@ causal_trace(problem="auth breaks after restart")
252
227
 
253
228
  ---
254
229
 
255
- ## MCP Tools (84 total)
230
+ ## MCP Tools (80 total)
256
231
 
257
232
  ### ๐Ÿง  Session & Memory (most used)
258
233
 
package/dist/index.js CHANGED
@@ -49,7 +49,7 @@ import { Redis } from 'ioredis';
49
49
  const API_URL = process.env.CACHLY_API_URL ?? 'https://api.cachly.dev';
50
50
  let JWT = process.env.CACHLY_JWT ?? '';
51
51
  const EMBED_MODEL = process.env.CACHLY_EMBED_MODEL ?? '';
52
- const CURRENT_VERSION = '0.10.44';
52
+ const CURRENT_VERSION = '0.10.46';
53
53
  // โ”€โ”€ Default Instance Resolution (for Smithery & single-credential setups) โ”€โ”€โ”€โ”€
54
54
  // When CACHLY_BRAIN_INSTANCE_ID is set, tools can omit the instance_id parameter.
55
55
  // When neither is set, we auto-fetch the first running instance once per process.
package/package.json CHANGED
@@ -1,14 +1,15 @@
1
1
  {
2
2
  "name": "@cachly-dev/mcp-server",
3
- "version": "0.10.44",
3
+ "version": "0.10.46",
4
4
  "mcpName": "io.github.cachly-dev/cachly-mcp",
5
- "description": "Your AI forgets everything between sessions. cachly fixes that permanently. Persistent memory + causal root-cause analysis for Claude Code, Cursor, Copilot & Windsurf. Learns from every bug fix, git commit, and CI run automatically. Arrives pre-briefed. Predicts failures before they happen. 89 MCP tools ยท Free tier forever ยท GDPR ยท EU servers.",
5
+ "description": "Your AI forgets everything between sessions. cachly fixes that permanently. Persistent memory + causal root-cause analysis for Claude Code, Cursor, Copilot & Windsurf. Learns from every bug fix, git commit, and CI run automatically. Arrives pre-briefed. Predicts failures before they happen. 80 MCP tools ยท Free tier forever ยท GDPR ยท EU servers.",
6
6
  "type": "module",
7
7
  "bin": {
8
8
  "cachly-mcp": "dist/index.js"
9
9
  },
10
10
  "main": "./dist/index.js",
11
11
  "scripts": {
12
+ "count-tools": "grep -c \"name: '\" src/tools.ts",
12
13
  "build": "tsc",
13
14
  "postinstall": "node scripts/postinstall.js",
14
15
  "dev": "tsx src/index.ts",
package/smithery.yaml CHANGED
@@ -4,7 +4,7 @@ description: >
4
4
  Your AI remembers every lesson, fix, and architecture decision โ€” forever.
5
5
  Features: causal root-cause analysis (causal_trace), failure prediction (brain_predict),
6
6
  git-ambient learning (brain_from_git), team knowledge sharing, Memory Crystals,
7
- BM25+ search in 11 languages. 84 MCP tools. Free tier. GDPR. German servers.
7
+ BM25+ search in 11 languages. 80 MCP tools. Free tier. GDPR. German servers.
8
8
  Zero-config: sign in once via browser, auto-provisions your Brain instance.
9
9
 
10
10
  startCommand:
package/src/index.ts CHANGED
@@ -60,7 +60,7 @@ import { Redis } from 'ioredis';
60
60
  const API_URL = process.env.CACHLY_API_URL ?? 'https://api.cachly.dev';
61
61
  let JWT = process.env.CACHLY_JWT ?? '';
62
62
  const EMBED_MODEL = process.env.CACHLY_EMBED_MODEL ?? '';
63
- const CURRENT_VERSION = '0.10.44';
63
+ const CURRENT_VERSION = '0.10.46';
64
64
 
65
65
  // โ”€โ”€ Default Instance Resolution (for Smithery & single-credential setups) โ”€โ”€โ”€โ”€
66
66
  // When CACHLY_BRAIN_INSTANCE_ID is set, tools can omit the instance_id parameter.