@kireo/mcp-server
Advanced tools
+21
-0
@@ -5,2 +5,23 @@ # Changelog | ||
| ## 0.2.2 — 2026-08-02 | ||
| Docs and packaging only — **no runtime changes**. The published code is byte-identical to 0.2.1. | ||
| - docs: the README now opens with a direct-answer block — what Kireo memory MCP is, and a | ||
| copy-paste server entry for Claude Code, Cursor, Cline, Claude Desktop, Windsurf and any other | ||
| MCP host, with the file each client expects it in. It also answers, in the README itself, the | ||
| questions people otherwise have to dig for: which eight tools ship, why memory is pulled rather | ||
| than injected into every prompt, how this differs from a `CLAUDE.md` / `.cursorrules` file, | ||
| whether `kireo index` uploads your code, and what it costs. | ||
| - chore: the public mirror repo gains `glama.json` (declares the maintainer so the Glama listing | ||
| can be claimed), a prepared `smithery.yaml` (not submitted yet), and a tag-triggered | ||
| `publish-mcp.yml` that publishes to the official MCP Registry over GitHub OIDC — no more | ||
| five-minute device-code tokens. | ||
| - chore: the private→public mirror sync is now a script (`scripts/promo/sync-mcp-mirror.sh`) | ||
| instead of remembered steps. It vendors `@kireo/shared`, keeps `server.json` in lockstep with | ||
| the version actually on npm, and is idempotent — re-running it when nothing changed does nothing. | ||
| The Glama badge is intentionally not in the README yet: the listing has to be claimed first, and a | ||
| badge for an unclaimed listing renders as a broken image. | ||
| ## 0.2.1 — 2026-07-12 | ||
@@ -7,0 +28,0 @@ |
+1
-1
@@ -759,3 +759,3 @@ 'use strict'; | ||
| // src/version.ts | ||
| var __KIREO_MCP_VERSION__ = "0.2.1" ; | ||
| var __KIREO_MCP_VERSION__ = "0.2.2" ; | ||
@@ -762,0 +762,0 @@ // src/tools/memory-health.ts |
+1
-1
@@ -751,3 +751,3 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js'; | ||
| // src/version.ts | ||
| var __KIREO_MCP_VERSION__ = "0.2.1" ; | ||
| var __KIREO_MCP_VERSION__ = "0.2.2" ; | ||
@@ -754,0 +754,0 @@ // src/tools/memory-health.ts |
+1
-1
| { | ||
| "name": "@kireo/mcp-server", | ||
| "version": "0.2.1", | ||
| "version": "0.2.2", | ||
| "mcpName": "io.github.wang1051992187/kireo", | ||
@@ -5,0 +5,0 @@ "description": "Long-term memory for Claude Code, Cursor, Cline & any MCP client — shared, searchable, with a web dashboard. Free beta.", |
+10
-5
@@ -9,11 +9,16 @@ # @kireo/mcp-server | ||
| 1. Get an API key at <https://app.kireo.app/api-keys> (`ki_sk_…`). | ||
| 1. Get an API key at <https://app.kireo.app/app/api-keys> (`ki_sk_…`). | ||
| 2. Add this MCP server to your host. **Claude Code** — run: | ||
| ```bash | ||
| claude mcp add kireo --env KIREO_API_KEY=ki_sk_xxx -- npx -y @kireo/mcp-server | ||
| claude mcp add kireo --scope user --env KIREO_API_KEY=ki_sk_xxx -- npx -y --package=@kireo/mcp-server kireo-mcp | ||
| ``` | ||
| Add `--scope user` to make it available in every project. Alternatively, check a project-scoped `.mcp.json` into your repo root with the same shape: | ||
| Two details in that line are load-bearing, both verified against claude 2.1.220 and npm 11 on 2026-08-03: | ||
| - **`--package=@kireo/mcp-server kireo-mcp`, not `@kireo/mcp-server`.** This package ships two binaries (`kireo`, `kireo-mcp`), neither named after the package, so `npx -y @kireo/mcp-server` cannot pick one and fails with `could not determine executable to run`. | ||
| - **`--package=`, not the short `-p`.** A bare `-p` after `--` gets swallowed by the `claude mcp add` option parser, which then rejects its own flag: `claude mcp add kireo --env … -- npx -y -p @kireo/mcp-server kireo-mcp` errors with `unknown option '--env'`. The long form parses cleanly. | ||
| Drop `--scope user` if you only want it in the current project. Alternatively, check a project-scoped `.mcp.json` into your repo root with the same shape (inside JSON `args` the short `-p` is fine — it goes straight to npx and never reaches the claude parser): | ||
| ```jsonc | ||
@@ -25,3 +30,3 @@ // .mcp.json (project root) | ||
| "command": "npx", | ||
| "args": ["-y", "@kireo/mcp-server"], | ||
| "args": ["-y", "--package=@kireo/mcp-server", "kireo-mcp"], | ||
| "env": { "KIREO_API_KEY": "ki_sk_xxx" } | ||
@@ -100,3 +105,3 @@ } | ||
| - `AUTH_INVALID_KEY` → rotate your key at <https://app.kireo.app/api-keys>. | ||
| - `AUTH_INVALID_KEY` → rotate your key at <https://app.kireo.app/app/api-keys>. | ||
| - `QUOTA_EXCEEDED` → upgrade or wait for next billing cycle. | ||
@@ -103,0 +108,0 @@ - Tools missing in your host → run `npx @modelcontextprotocol/inspector node $(npm root -g)/@kireo/mcp-server/bin/kireo-mcp.cjs` to verify locally. |
452544
0.51%110
4.76%