memkin
Memkin is a local-first personal memory graph server providing AI agents with 36 MCP tools to read, write, and explore structured memories derived from chats, meetings, emails, and coding sessions.
🔍 Search & Retrieval
query— Semantic/fuzzy search across all memory using natural languagesearch— Exact keyword search for known identifiers or phrasesget_page_context— Read a specific memory page with tags, links, backlinks, and timelinetimeline_feed— Browse the global timeline with date, source, and keyword filtersexplore_graph— Traverse the knowledge graph to discover dependencies, collaborators, and related entities
🧠 Synthesis & Insights
recall/synthesize— Generate cited, gap-aware summaries or composed answers from memoryprep_for_person— Goal-conditioned communication strategy based on a person's passively inferred profiledaily_report— Cross-channel daily report covering decisions, todos, completed work, pending replies, and reminderstroubleshoot— Step-by-step playbook walkthrough for a given problemget_session_context— Load working memory summary at session start to quickly resume context
✍️ Writing & Memory Updates
put_page— Create or idempotently update a durable memory page with markdown contentadd_timeline_entry— Append a dated event to an existing pagemanage_links— Add/remove directed graph relationships (e.g., mentions, depends_on) between pagesmanage_tags— Add/remove classification tags on memory pages
👤 Person & Entity Management
get_entity_profile/list_signals_by_entity— Retrieve full profiles and all signals for people, projects, or toolslink_person_alias/remove_person_alias/list_person_handles— Manage known aliases and handlesmerge_persons/recanonicalize_person— Merge duplicate person pages or rename canonical slugs
⚙️ System
get_health— Check server status, page/chunk counts, MCP version, and capability flags
Allows bidirectional synchronization between Memkin's memory pages and an Obsidian vault, enabling editing of memory pages in Markdown and importing changes back.
Allows using a local Ollama instance for generating vector embeddings, keeping data fully private without external API calls.
Allows using OpenAI's API for LLM-based signal extraction and vector embeddings for the memory system.
AI Agent 的会话没有跨会话记忆:每次新会话都需要重新解释你是谁、项目背景、既有决策。Memkin 把散落在飞书(私信、群聊、邮件、日历、文档、任务)和 AI 编程会话(Claude Code、Codex、Hermes)里的信息提取为结构化信号——实体、决策、任务、发现、知识、关系——存入你自己机器上的知识图谱,并通过 MCP 提供给任何 Agent 查询和写回。数据全程保留在本机。
核心特性
飞书采集:私信、群聊、邮件、日历、文档、任务、消息搜索共 7 个源,增量采集 + 历史回填。见飞书采集指南
AI 会话采集:Claude Code(
~/.claude/projects/)、Codex(~/.codex/)、Hermes/OpenClaw(~/.openclaw/agents/)MCP 服务器:36 个工具(默认暴露 15 个高意图工具),支持 stdio 与 Streamable HTTP 两种传输。见 MCP 接入指南
信号提取:LLM Pipeline 提取 7 类结构化信号,双层噪声过滤(规则 + LLM 打分),每条信号可溯源到原始消息
混合检索:tsvector 全文(支持中文)+ pgvector 向量,RRF 融合排序
知识图谱:信号锚定到实体(人、项目、工具),有向链接图,跨平台人物身份归并
隐私:写入前脱敏(可逆 / 不可逆双轨),存储零云依赖(PGLite 嵌入式数据库),可选 Ollama 本地嵌入
常驻服务:
memkin up注册开机自启 daemon,定时采集,带运行历史与告警记忆巩固:hot → warm → cold 分层轮转、死链修复、偏好推断
Obsidian 双向同步:导出为 Markdown vault,编辑后导回
Web UI:Dashboard、时间线、力导向知识图谱、搜索
完整清单见功能清单。
Related MCP server: auxly-memory-cli
快速上手
一键安装(推荐,注册为后台常驻服务):
curl -fsSL https://raw.githubusercontent.com/AndreLYL/memkin/main/scripts/install.sh | sh脚本依次执行:安装 Node 运行时(如缺失)→ npm install -g memkin → 打开浏览器 setup 向导(填入 LLM API Key)→ memkin up 注册开机自启后台服务,并把 MCP 配置写入本机已安装的 AI 客户端(Claude Code、Codex、Hermes/OpenClaw)。
临时试用(不安装后台服务):
npx memkin start # 无配置时自动进入 setup 向导,完成后启动服务并打开 Web UI服务管理与卸载:
memkin status # 查看后台服务状态
memkin down # 停止服务并取消开机自启
memkin down && memkin uninstall && npm rm -g memkin # 完全卸载前置条件:Node.js >= 18(安装脚本会自动处理)。
接入 AI Agent
memkin install 把 MCP 配置和记忆使用指令写入本机 AI 客户端,支持 Claude Code、Claude Desktop、Cursor、Codex、Windsurf、Hermes/OpenClaw:
memkin install # 探测已安装的客户端并接入
memkin install --agent claude-code # 指定单个客户端
memkin install --dry-run # 预览将修改的文件
memkin extract --source claude-code # 把历史会话提取为记忆
memkin hooks install # (可选)Claude Code 自动召回 hooks接入后重启客户端即可。传输方式(stdio / Streamable HTTP)、手动配置和 hooks 说明见 MCP 接入指南。
使用场景
以下问题均可在接入 Memkin 的 Agent 中直接提问,回答带 [n] 引用,可溯源到原始消息:
问题 | 使用的工具 |
"明天要见张总谈续约,该注意什么?" |
|
"生成今天的日报" |
|
"智驾为什么无法激活?" |
|
"memkin 项目现在进展如何?" |
|
"上周和这位同事聊了什么?" |
|
界面预览
架构
数据流为 5 层:数据源采集 → 信号提取 → 本地存储 → 接口输出;人物身份、记忆巩固、调度三个模块横切各层。
层 | 内容 |
配置与上手 | TUI 配置中心 / 浏览器向导,自动检测与连接测试 |
采集 | 飞书 7 源 + Claude Code / Codex / Hermes,增量 + 历史回填 |
信号提取 | 分块 → 双层噪声过滤 → LLM 抽取 → 打分 → 隐私脱敏 |
记忆存储 | PGLite + pgvector,混合检索(全文 + 向量 + RRF) |
接口 | CLI、MCP、REST API、Web UI、Obsidian |
运行平台:macOS / Linux / Windows(默认 PGLite,零外部依赖)。可选的自管理本地 Postgres 引擎支持 macOS(arm64 / x64)与 Linux(x64 / arm64)。详见架构详解。
常用命令
命令 | 说明 |
| 启动(无配置时自动进入 setup) |
| 后台服务:注册开机自启 / 停止 / 状态 |
| 接入 AI 客户端 |
| 从数据源提取信号 |
| 搜索记忆 |
| 环境诊断 |
完整命令见 CLI 参考。
文档
路线图
更多数据源:钉钉、企业微信、微信聊天记录、本地文档
提取质量:跨 block 共享上下文、加权准入评分、按实体聚合叙事
自然语言问答
Web UI:记忆编辑(当前只读)、信号溯源审计视图
致谢
Memkin 的设计与实现受益于以下项目:
lark-cli —— 飞书开放平台官方 CLI,Memkin 的飞书 user 态采集构建在它之上
GBrain —— brain-first 检索约定、自布线知识图谱与带引用的合成回答
OpenHuman —— Memory Tree 层级压缩与 Obsidian 互通的设计
mem0 —— Agent 记忆层的先行者
与它们相比,Memkin 侧重:飞书等中国职场工具的采集、本地优先零云依赖、Agent 经 MCP 读写。
贡献
Bug 报告和功能建议请提交 issue。开发流程见 CONTRIBUTING.md。
License
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityBmaintenanceA local-first MCP server for personal memory management, enabling AI agents to store, search, and retrieve developer insights with offline semantic search and auto-categorization.Last updated353MIT
- Alicense-qualityAmaintenanceLocal-first, file-based memory layer for AI agents — one shared Markdown vault across Claude, Codex, Gemini, Cursor and any MCP client. Provides read/write memory tools with an audit trail, per-agent trust levels, and Git sync; no cloud and no lock-in.Last updated2MIT
- Alicense-qualityAmaintenanceA local-first AI secretary that gathers your work context into private memory and enables AI agents to search and summarize it over MCP.Last updated86MIT
- Flicense-qualityAmaintenanceLocal-first cross-agent memory for AI coding agents. Persistent, shared memory over MCP — what you tell one agent can be recalled by another — with all data stored in a single local SQLite file, no cloud and no API keys.Last updated
Related MCP Connectors
User-owned memory for AI agents, Copilot, Claude, IDEs, CLIs, and chat apps over remote MCP.
Universal memory for AI agents and tools. Save, organize and search context anywhere.
Persistent memory and knowledge graphs for AI agents. Hybrid search, context checkpoints, and more.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/AndreLYL/memkin'
If you have feedback or need assistance with the MCP directory API, please join our Discord server