@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 +41 -66
- package/dist/index.js +1 -1
- package/package.json +3 -2
- package/smithery.yaml +1 -1
- package/src/index.ts +1 -1
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# ๐ง cachly AI Brain โ MCP Server
|
|
2
2
|
|
|
3
|
-
> **
|
|
4
|
-
> Stop re-teaching your
|
|
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
|
|
|
23
|
-
<img src="https://img.shields.io/badge/
|
|
23
|
+
<img src="https://img.shields.io/badge/80%20MCP%20tools-violet" alt="80 MCP tools" />
|
|
24
24
|
|
|
25
25
|
<img src="https://img.shields.io/badge/License-Apache--2.0-yellow" alt="License: Apache-2.0" />
|
|
26
26
|
|
|
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
|
-
|
|
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
|
|
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
|
-
โ
|
|
44
|
+
โ Brain Preview โ What your AI would know โ
|
|
49
45
|
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
|
|
50
|
-
โ Commits
|
|
51
|
-
โ
|
|
46
|
+
โ Commits: 847 Lessons: 634 Contributors: 7 โ
|
|
47
|
+
โ Date range: 2024-01-12 โ 2026-05-14 โ
|
|
52
48
|
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
|
|
53
|
-
โ Category breakdown:
|
|
54
|
-
โ
|
|
55
|
-
โ
|
|
56
|
-
โ
|
|
57
|
-
โ
|
|
49
|
+
โ Category breakdown: โ
|
|
50
|
+
โ fix โโโโโโโโโโโโโโโโโโโโ 312 โ
|
|
51
|
+
โ feat โโโโโโโโโโโโโโโ 189 โ
|
|
52
|
+
โ security โโ 18 โ
|
|
53
|
+
โ deploy โโ 15 โ
|
|
58
54
|
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
|
|
59
|
-
โ
|
|
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
|
-
โ
|
|
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
|
-
โ
|
|
70
|
-
โ
|
|
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 (
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|