@cachly-dev/mcp-server 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -0,0 +1,97 @@
+# Changelog – cachly SDK (mcp)
+
+**Language:** MCP (Model Context Protocol)  
+**Package:** `@cachly-dev/mcp-server` on **npm**
+
+> Full cross-SDK release notes: [../CHANGELOG.md](../CHANGELOG.md)
+
+---
+
+## [0.5.37] – 2026-04-24
+
+### Added
+
+- **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 (`و`,`ب`,`ل`,`ف`,`ك`)
+- **Arabic and Hebrew stopwords** — ~60 high-frequency function words per language added to the STOPWORDS set
+- **Romanization matching** — katakana segments now additionally emit Hepburn romaji tokens at index time (e.g. `デプロイ` → `depuroi`), so users can query Japanese docs using romaji
+- **Full katakana→romaji converter** — handles digraphs (シャ→sha, チェ→che, ファ→fa), voiced consonants, geminate consonants (ッ), long vowel marks (ー), and loanword combinations
+- **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)
+- **73 unit tests** all passing — new test suites for `katakanaToRomaji`, `arabicLightStem`, `expandCrossLingual`, RTL tokenization, and cross-lingual expansion
+
+---
+
+## [0.5.36] – 2026-04-22
+
+### Added
+
+- **Roadmap tools** — `roadmap_add`, `roadmap_update`, `roadmap_list`, `roadmap_next` for persistent project planning inside the Brain
+- `session_start` now shows open roadmap items automatically
+
+---
+
+## [0.5.35] – 2026-04-20
+
+### Added
+
+- **CJK language support** — Chinese (Simplified + Traditional), Japanese, Korean
+- Character bigram extraction for CJK Unicode ranges
+- ~140 CJK stopwords (Chinese particles, Japanese hiragana particles, Korean postpositions)
+
+---
+
+
+
+### Added
+
+- **`setup` command** — interactive zero-arg CLI wizard (`npx @cachly-dev/mcp-server setup`):
+  - Reads `CACHLY_JWT` from env or prompts interactively via readline
+  - Fetches instances from API; presents list when multiple exist
+  - Auto-detects installed editors (Cursor, Windsurf, VS Code, Continue.dev) by checking for their config directories
+  - Writes the correct MCP config file for each detected editor in one step
+  - Always writes/updates `CLAUDE.md` (idempotent via `<!-- cachly-brain-start/end -->` markers)
+- **`init` command** now idempotent — re-running `npx @cachly-dev/mcp-server init` updates the brain block in `CLAUDE.md` instead of appending a duplicate
+- Shared helpers: `buildMcpConfig()`, `buildClaudeMdBlock()`, `writeClaudeMd()` — used by both `setup` and `init`
+
+### Fixed
+
+- `init` no longer duplicates the brain block in `CLAUDE.md` when run multiple times
+- Correct package name `@cachly-dev/mcp-server` used consistently (was `@cachly-dev/mcp` in generated configs)
+
+---
+
+## [0.1.1] – 2026-04-07
+
+### Fixed
+
+- Broken `index_project` tool schema – properties were accidentally placed outside the `TOOLS` array
+- Unused `openai` variable removed from `cache_warmup` handler
+- `readdir` type mismatch (`Dirent<string>` vs. `NonSharedBuffer`) fixed
+- Version bumped to `0.3.0` in server metadata
+
+---
+
+## [0.1.0] – 2026-04-07
+
+Initial release.
+
+### Added
+
+- MCP tool: `cache_set` – store a value with optional TTL
+- MCP tool: `cache_get` – retrieve a cached value
+- MCP tool: `cache_delete` – remove a key
+- MCP tool: `semantic_search` – vector-similarity lookup for LLM response caching
+- MCP tool: `cache_clear` – flush namespace or entire cache
+- Compatible with Claude Desktop, Cursor, Windsurf, and any MCP-capable host
+- API-key-based authentication
+- EU data residency (German servers, DSGVO compliant)
+
+### Known limitations
+
+- ~~Streaming tools not yet supported~~ (tracked for a future release)
+
+---
+
+## [Unreleased]
+
+See [../CHANGELOG.md](../CHANGELOG.md) for upcoming features.
+

package/Dockerfile

@@ -1,19 +1,16 @@
-FROM node:22-alpine
+FROM node:22-alpine AS builder
 WORKDIR /app
-
-# Install dependencies
-COPY package*.json ./
-RUN npm ci
-
-# Build TypeScript
+COPY package*.json tsconfig*.json ./
+RUN npm ci --ignore-scripts
 COPY src/ ./src/
-COPY tsconfig.json ./
-RUN npm run build && npm prune --omit=dev
-
-# MCP servers communicate over stdio — no port needed
-ENV CACHLY_JWT=""
-ENV CACHLY_INSTANCE_ID=""
-ENV CACHLY_NO_TELEMETRY=1
-ENV CACHLY_NO_UPDATE_CHECK=1
+RUN npm run build
 
+FROM node:22-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --omit=dev --ignore-scripts
+COPY --from=builder /app/dist/ ./dist/
+ENV NODE_ENV=production
+ENV PORT=3000
+EXPOSE 3000
 ENTRYPOINT ["node", "dist/index.js"]