Kimi Memory MCP
Uses Ollama's bge-m3 model for local embedding, enabling privacy-preserving vector generation for memory search.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Kimi Memory MCP 学习 /home/docs/api.md,后端API文档"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Kimi Memory MCP
为 Kimi Code CLI 打造的智能记忆系统,让大模型拥有持久化记忆能力。
功能特性
📚 文件学习 - 学习代码、文档、会议记录等各种文件
🔍 智能检索 - 使用自然语言查询已学习内容
🧠 混合存储 - 同时存储原始内容和 AI 整理后的结构化内容
🤖 智能预处理 - 自动调用 DeepSeek 整理复杂文档
🔒 本地 Embedding - 使用 Ollama + bge-m3,保护隐私
💾 持久化存储 - 数据存储在 ChromaDB,重启不丢失
Related MCP server: Vector Memory MCP Server
系统架构
┌─────────────────────────────────────────────────────────┐
│ Kimi Code CLI │
└──────────────────┬──────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ Memory MCP Server (Node.js + TypeScript) │
│ ├── embed_file - 学习文件 │
│ ├── search_memory - 检索记忆 │
│ ├── list_memories - 列出记忆 │
│ └── forget_file - 删除记忆 │
└──────────────────┬──────────────────────────────────────┘
│
┌───────────┴───────────┐
▼ ▼
┌─────────────┐ ┌─────────────┐
│ Ollama │ │ DeepSeek │
│ (bge-m3) │ │ API │
│ Embedding │ │ 内容整理 │
└──────┬──────┘ └─────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ ChromaDB (Docker) │
│ └── 向量存储 + 元数据 │
└─────────────────────────────────────────────────────────┘快速开始
1. 克隆项目
git clone https://github.com/yourusername/kimi-memory-mcp.git
cd kimi-memory-mcp2. 安装依赖
npm install
npm run build3. 启动 ChromaDB
docker run -d --name chromadb -p 8000:8000 chromadb/chroma:latest4. 配置 MCP
编辑 ~/.kimi/mcp.json:
{
"mcpServers": {
"memory": {
"command": "node",
"args": ["/path/to/kimi-memory-mcp/dist/index.js"],
"env": {
"ANTHROPIC_AUTH_TOKEN": "your-deepseek-api-key",
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_MODEL": "deepseek-chat"
}
}
}
}5. 重启 Kimi CLI
重启 Kimi Code CLI 后,记忆功能即可使用。
使用方法
学习文件
> 学习 /path/to/auth.js,用户认证模块
> 学习 /path/to/API设计.md,后端接口规范
> 学习 /path/to/周会.md,本周开发计划检索记忆
> 回忆一下用户登录怎么实现
> 上周会议说的待办事项有哪些
> 之前学习的认证相关代码在哪里管理记忆
> 查看我已让你学习的所有文件
> 忘记 /path/to/旧文件.js项目结构
kimi-memory-mcp/
├── src/
│ ├── index.ts # MCP 服务器入口
│ ├── tools/
│ │ ├── embed.ts # 学习文件
│ │ ├── search.ts # 检索记忆
│ │ ├── list.ts # 列出记忆
│ │ └── forget.ts # 删除记忆
│ ├── store/
│ │ └── chroma_http.ts # ChromaDB HTTP 客户端
│ └── utils/
│ ├── ollama.ts # Ollama API 封装
│ ├── deepseek.ts # DeepSeek API 封装
│ └── splitter.ts # 文件切片器
├── dist/ # 编译后的 JS
├── package.json
├── tsconfig.json
└── README.md环境变量
变量名 | 说明 | 默认值 |
| DeepSeek API Key | 必填 |
| DeepSeek API 地址 |
|
| 使用的模型 |
|
| ChromaDB 地址 |
|
| Ollama 地址 |
|
技术亮点
1. 混合存储
同时存储原始内容和 AI 整理后的结构化内容:
检索时优先匹配结构化内容(更准确)
需要细节时查看原始内容(更完整)
2. 智能预处理
自动判断文件类型:
代码文件(.py, .js, .ts等)→ 直接切片
文档类(.md, .txt)→ DeepSeek 整理后存储
3. 本地 Embedding
使用 Ollama 本地运行 bge-m3 模型:
无需联网即可生成向量
保护数据隐私
免费使用
依赖要求
Node.js >= 18
Docker (用于运行 ChromaDB)
Ollama (本地 Embedding 服务)
DeepSeek API Key (文档预处理)
安装依赖服务
Ollama
# macOS/Linux
curl -fsSL https://ollama.com/install.sh | sh
# Windows
# 下载安装包: https://ollama.com/download/windows拉取 bge-m3 模型
ollama pull bge-m3开发
# 开发模式(自动编译)
npm run dev
# 构建
npm run build
# 测试连接
node dist/index.js许可证
MIT License
致谢
Available Tools
4 toolsembed_fileA
当用户需要保存文件内容、学习新知识、记住某个文件、将文件加入知识库、存储代码或文档时,调用此工具。触发场景包括:用户说"学习这个文件"、"记住这个文件"、"保存到记忆"、"加入知识库"、"存储这个文档"、"把这个代码记下来"等。支持DeepSeek自动预处理复杂内容。
Inputs: file_path (required), description (required), preprocess.
forget_fileA
删除指定文件的所有记忆。当用户说"忘记这个文件"、"删除记忆"、"清除这个文件"、"移除知识库中的文件"、"删掉这个记录"时,使用此工具清除相关记忆。
Inputs: file_path (required).
list_memoriesA
列出所有已学习的文件及其统计信息。当用户问"查看已学习的文件"、"显示记忆列表"、"都有什么文件"、"知识库里有什么"、"列出所有内容"、"查看记忆"时,使用此工具。
Inputs: file_type.
search_memoryA
在已学习的知识库中搜索相关内容。当用户需要查找之前的内容、寻找历史信息、查询已保存的文件、回顾之前的讨论、找之前的代码或文档、查看学习过的资料、检索记忆时,使用此工具。触发词包括:回忆、找、查、搜索、看看、之前、以前、上次、有没有、记得、说过、讨论过等。
Inputs: query (required), limit, source, file_type.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool maps to a distinct operation: saving content, searching, listing, and deleting memories. There is no overlap in purpose, and the trigger scenarios clearly differentiate them.
All tool names follow a consistent verb_noun pattern (embed_file, search_memory, list_memories, forget_file). The pattern is uniform and predictable.
With only 4 tools, the server is tightly scoped to its core memory management purpose. Each tool is necessary and there is no bloat.
The set covers create, read, list, and delete operations, covering the primary lifecycle. The only missing operation is an explicit update, but users can achieve updates by forgetting and re-embedding, so the gap is minor.
Maintenance
Related MCP Connectors
Universal persistent memory and knowledge retrieval layer for AI agents and LLMs.
Persistent memory layer for AI clients: store, recall, and correct context across tools.
Persistent memory for AI agents: one brain shared across Claude, Cursor, Codex and more.
Persistent memory for AI agents — shared .brain across Claude Code, Cursor & Codex
Related MCP Servers
- AlicenseAqualityDmaintenanceA personal memory system that provides AI assistants with long-term memory capabilities through semantic search and vector storage. It enables Claude Code to store, retrieve, and manage personal context and project preferences using flexible LLM backends.8MIT
- AlicenseNot gradedqualityDmaintenanceAdds persistent long-term memory to GitHub Copilot CLI via local semantic vector search, enabling Copilot to recall past conversations and code decisions across sessions.22 npm1MIT
- AlicenseNot gradedqualityDmaintenanceProvides persistent memory and semantic file discovery for AI coding agents, enabling them to remember changes and find relevant files across sessions.5MIT
- AlicenseAqualityBmaintenanceProvides persistent, searchable memory across AI coding agent and chat history (Claude Code, Codex, Gemini CLI, ChatGPT, and more) via retrieval-augmented generation, enabling semantic and hybrid search to retain context across sessions.5MIT