🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP
Sign In

@kireo/mcp-server

Package Overview
Dependencies
Maintainers
1
Versions
5
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@kireo/mcp-server - npm Package Compare versions

Comparing version
0.2.1
to
0.2.2
+21
-0
CHANGELOG.md

@@ -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

@@ -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

{
"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.",

@@ -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.