kimi-code-memory-mcp-server 0.1.0

package/examples/sample-workspace/index.json

@@ -0,0 +1,36 @@
+{
+  "version": "3-kv",
+  "meta": {
+    "lastSyncAt": "2026-06-20T10:20:00.000Z",
+    "structureHash": "00000000000000000000000000000000"
+  },
+  "index": {
+    "memory/": { "comment": "Memory index" },
+    "memory/decisions/": { "comment": "Architecture and product decisions" },
+    "memory/decisions/choose-sqlite-cache.md": {
+      "title": "Choose SQLite for Cache Layer",
+      "tags": ["decision", "database", "cache"]
+    },
+    "memory/knowledge/": { "comment": "Project knowledge" },
+    "memory/knowledge/project-tech-stack.md": {
+      "title": "Project Tech Stack",
+      "tags": ["knowledge", "stack", "architecture"]
+    },
+    "memory/rules/": { "comment": "Conventions and guardrails" },
+    "memory/rules/no-plaintext-secrets.md": {
+      "title": "No Plaintext Secrets in Memory",
+      "tags": ["rule", "security", "workflow"]
+    },
+    "memory/reference/": { "comment": "External references" },
+    "memory/reference/mcp-spec.md": {
+      "title": "MCP Specification Reference",
+      "tags": ["reference", "mcp", "external"]
+    },
+    "essence/": { "comment": "Workspace essence" },
+    "essence/essence.md": {
+      "title": "Workspace Essence",
+      "tags": ["essence", "workspace-memory"]
+    },
+    "themes/": { "comment": "Theme associations" }
+  }
+}

package/examples/sample-workspace/memory/decisions/sample-decision.md

@@ -0,0 +1,30 @@
+---
+key: 'choose-sqlite-cache'
+title: 'Choose SQLite for Cache Layer'
+tags:
+  - decision
+  - database
+  - cache
+createdAt: '2026-06-20T10:00:00.000Z'
+updatedAt: '2026-06-20T10:00:00.000Z'
+---
+
+# Choose SQLite for Cache Layer
+
+## Decision
+
+Use SQLite as the local cache layer instead of Redis or an in-memory store.
+
+## Rationale
+
+- **Single-file deployment**: no separate service to run.
+- **Sufficient for read-heavy workloads**: cache hits are mostly reads.
+- **Familiar tooling**: most developers already know SQL.
+- **No network latency**: local file access is fast enough for this scale.
+
+## Consequences
+
+- Write-heavy bursts may become a bottleneck; monitor cache invalidation patterns.
+- Backup strategy must include the SQLite file.
+
+> 来源：memory/decisions/choose-sqlite-cache

package/examples/sample-workspace/memory/knowledge/sample-knowledge.md

@@ -0,0 +1,24 @@
+---
+key: 'project-tech-stack'
+title: 'Project Tech Stack'
+tags:
+  - knowledge
+  - stack
+  - architecture
+createdAt: '2026-06-20T10:05:00.000Z'
+updatedAt: '2026-06-20T10:05:00.000Z'
+---
+
+# Project Tech Stack
+
+- **Runtime**: Node.js >= 18
+- **Protocol**: Model Context Protocol (MCP) over stdio
+- **Storage**: Markdown files + rebuildable JSON index
+- **Linting**: ESLint + Prettier
+- **Testing**: Node.js built-in `assert` + `@modelcontextprotocol/sdk` client
+
+## Notes
+
+The server intentionally avoids external databases by default. Optional embedding or vector plugins may be added later as extensions.
+
+> 来源：memory/knowledge/project-tech-stack

package/examples/sample-workspace/memory/reference/sample-reference.md

@@ -0,0 +1,20 @@
+---
+key: 'mcp-spec'
+title: 'MCP Specification Reference'
+tags:
+  - reference
+  - mcp
+  - external
+createdAt: '2026-06-20T10:15:00.000Z'
+updatedAt: '2026-06-20T10:15:00.000Z'
+---
+
+# MCP Specification Reference
+
+- **URL**: https://modelcontextprotocol.io/
+- **Type**: External reference
+- **Relevance**: Defines the stdio transport and tool schema used by this server.
+
+Keep this reference up to date when bumping `@modelcontextprotocol/sdk` versions.
+
+> 来源：memory/reference/mcp-spec

package/examples/sample-workspace/memory/rules/sample-rule.md

@@ -0,0 +1,31 @@
+---
+key: 'no-plaintext-secrets'
+title: 'No Plaintext Secrets in Memory'
+tags:
+  - rule
+  - security
+  - workflow
+createdAt: '2026-06-20T10:10:00.000Z'
+updatedAt: '2026-06-20T10:10:00.000Z'
+---
+
+# No Plaintext Secrets in Memory
+
+## Rule
+
+Never store API keys, passwords, tokens, or other secrets in `memory/` or `notes/`.
+
+## Scope
+
+Applies to all memories written by agents or edited by users.
+
+## Why
+
+Memories are stored as plain Markdown files and may be committed to git or shared across workspaces.
+
+## Enforcement
+
+- Agents should reject `remember` calls that contain secret-like strings.
+- Users should review memories before committing them to version control.
+
+> 来源：memory/rules/no-plaintext-secrets

package/examples/sample-workspace/themes/cache-design.json

@@ -0,0 +1,15 @@
+{
+  "theme": "cache-design",
+  "displayName": "Cache Design",
+  "createdAt": "2026-06-20T10:20:00.000Z",
+  "updatedAt": "2026-06-20T10:20:00.000Z",
+  "turns": [],
+  "memories": [
+    {
+      "key": "choose-sqlite-cache",
+      "folder": "memory/decisions",
+      "title": "Choose SQLite for Cache Layer",
+      "timestamp": "2026-06-20T10:00:00.000Z"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "kimi-code-memory-mcp-server",
+  "version": "0.1.0",
+  "description": "Local stdio MCP server providing cross-session memory for Kimi Code CLI",
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "type": "module",
+  "bin": {
+    "kimi-code-memory-mcp-server": "dist/server.js"
+  },
+  "files": [
+    "dist/",
+    "docs/",
+    "examples/",
+    "skills/",
+    "AGENTS.md",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "sync-version": "node scripts/sync-version.mjs",
+    "build": "npm run sync-version && tsc",
+    "dev": "tsx src/server.ts",
+    "start": "node dist/server.js",
+    "test": "tsx tests/test.ts",
+    "lint": "eslint src tests",
+    "lint:fix": "eslint src tests --fix",
+    "format": "prettier --write src tests",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.tests.json"
+  },
+  "keywords": [
+    "mcp",
+    "memory",
+    "kimi",
+    "kimi-code",
+    "cli",
+    "kimi-memory",
+    "cross-session",
+    "markdown"
+  ],
+  "author": "Zehee <zehee@vip.qq.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Zehee/kimi-code-memory-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Zehee/kimi-code-memory-mcp-server/issues"
+  },
+  "homepage": "https://github.com/Zehee/kimi-code-memory-mcp-server#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "better-sqlite3": "^12.11.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.62.0",
+    "@typescript-eslint/parser": "^8.62.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "prettier": "^3.2.5",
+    "ts-migrate": "^0.1.35",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/skills/memory-manage/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: memory-manage
+description: 提示 agent 在用户表达记忆相关意图时调用 kimi-memory MCP 工具
+type: prompt
+whenToUse: >
+  当用户表达以下任一意图时：
+  1. "记住"、"记下来"、"保存决策/规则/知识"
+  2. "删除"、"移除"、"清理" 某条记忆
+  3. "列出"、"看看"、"有哪些" 记忆
+  4. "查找"、"搜索" 记忆或上下文
+  5. "恢复"、"加载"、"读取" 上次上下文或某条记忆
+  6. "归档"、"移动" 记忆到另一个 folder
+  7. "整理"、"重新组织"、"合并重复" 记忆
+  8. "有哪些标签"
+  9. "速记"、"便签"、"个人笔记"
+  10. "主题"、"这个话题怎么发展的"、"回顾一下 xx"、"把这条记录关联到 xx 主题"、"有哪些主题"
+---
+
+# 记忆工具调度提示
+
+本 Skill 是轻量提醒。当用户意图匹配上述任一情况时，调用对应的 `mcp__kimi-memory__*` 工具。
+
+## 快速映射
+
+| 用户意图 | 工具 |
+|----------|------|
+| "记住…" / "保存…" | `mcp__kimi-memory__remember` |
+| "读取…" / "看看…" | `mcp__kimi-memory__recall` |
+| "搜索记忆…" | `mcp__kimi-memory__search` |
+| "列出记忆/标签" | `mcp__kimi-memory__list` / `mcp__kimi-memory__list_tags` |
+| "移动/归档…" | `mcp__kimi-memory__move` |
+| "删除…" | `mcp__kimi-memory__delete` |
+| "整理记忆" | `mcp__kimi-memory__organize_memories` |
+| "同步索引" | `mcp__kimi-memory__sync_workspace_index` |
+| "搜索历史对话" | `mcp__kimi-memory__search_context` |
+| "加载第 N 轮" | `mcp__kimi-memory__load_turn_context` |
+| "查看搜索视图" | `mcp__kimi-memory__list_search_views` |
+| "关联到主题" | `mcp__kimi-memory__tag_theme` |
+| "追溯主题" | `mcp__kimi-memory__trace_theme` |
+| "列出主题" | `mcp__kimi-memory__list_themes` |
+| "手动精炼轮次" | `mcp__kimi-memory__refine_session_turns` |
+
+行为规范（何时 remember、决策守卫、主题追溯协议）见 `AGENTS.md`。