Hindsight
Click on "Install 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., "@Hindsightwhat do you remember about my project?"
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.
Hindsight
为 AI 编程助手提供持久化记忆的开源 MCP 服务器。
功能特性
持久化记忆:记录对话内容,追踪文件变更,提取用户偏好与决策
自动画像生成:根据交互数据构建用户画像,自动注入 AGENTS.md
上下文感知:新的 AI 会话启动时即可获取你的编码风格和项目历史
多项目隔离:每个项目独立存储记忆,同时支持全局用户偏好
文件监控:自动追踪文件的创建、修改和删除操作
Related MCP server: iai-personal-memory-engine
架构概览
┌──────────────────────────────────────────────────────┐
│ MCP Server (std io) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ index.ts │ │ profiler.ts │ │ fileWatcher │ │
│ │ (工具路由) │ │ (画像生成) │ │ (文件监控) │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ └────────────────┼────────────────┼─────────┘ │
│ ┌─────▼─────┐ │
│ │ store.ts │ ◄────────┘
│ │ (SQLite) │
│ └─────┬─────┘
└──────────────────────────┼───────────────────────────┘
│
┌────────────▼────────────┐
│ ~/.hindsight/hindsight.db │
│ ~/.config/opencode/AGENTS.md │
└─────────────────────────┘核心模块
src/index.ts— MCP 服务器入口,定义 7 个工具并处理请求路由src/store.ts— SQLite 存储层,管理对话、文件事件和记忆的 CRUDsrc/profiler.ts— 画像生成器,从对话和文件事件中提取偏好、模式与决策src/fileWatcher.ts— 基于 chokidar 的文件监控,过滤构建目录和临时文件src/types.ts— TypeScript 类型定义(对话事件、文件事件、记忆、用户画像)
安装
npm install
npm run build配置
将以下配置添加到 OpenCode 配置文件(~/.config/opencode/opencode.json):
{
"mcpServers": {
"hindsight": {
"command": "node",
"args": ["path/to/hindsight/dist/index.js"]
}
}
}MCP 工具
工具名 | 说明 | 必需参数 |
| 记录用户与 AI 的对话内容 |
|
| 开始监控指定目录的文件变化 |
|
| 停止文件监控 | 无 |
| 获取当前用户画像和上下文 | 无 |
| 查询已存储的记忆(支持类型过滤) | 无 |
| 手动添加一条记忆 |
|
| 基于最新数据刷新用户画像 | 无 |
记忆类型
preference — 用户偏好(如技术选型偏好、编码习惯)
pattern — 编码模式(如常用的文件结构、设计模式)
decision — 项目决策(架构选择、技术取舍)
context — 上下文信息(当前活跃目录、文件类型分布)
工作原理
记录交互:捕获对话内容和文件变更事件
提取模式:通过关键词匹配识别用户偏好、决策和编码模式
生成画像:将提取的信息聚合为结构化用户画像,写入 AGENTS.md
提供上下文:AI 助手在启动时读取画像,获得完整的用户上下文
数据存储
数据库:
~/.hindsight/hindsight.db(SQLite,通过 sql.js 运行)用户画像:
~/.config/opencode/AGENTS.md(HINDSIGHT 标记区间自动更新)自动清理:30 天前的记录自动删除,文件事件上限 10,000 条
自动保存:数据库变更每 500ms 异步刷盘
开发
npm run dev # 监听模式编译
npm run test # 运行集成测试许可证
MIT
This server cannot be installed
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
- AlicenseBqualityBmaintenanceAn MCP server that gives AI assistants persistent memory across sessions. It stores project context, decisions, and progress in structured markdown files as well as a knowledge graph and sequential thinking for better memory storage.36371MIT
- AlicenseAqualityAmaintenanceA local MCP server that gives AI assistants a long-term memory by capturing sessions verbatim and surfacing relevant context automatically.14793MIT
- AlicenseNot gradedqualityAmaintenanceSelf-hosted MCP server giving AI agents persistent memory for personalization and context across conversations.272Apache 2.0
- AlicenseNot gradedqualityCmaintenanceAn MCP server that gives AI coding assistants persistent memory across sessions with chain-based project tracking, tickets, and structured handoffs.GPL 3.0
Related MCP Connectors
Cloud-hosted MCP server for durable AI memory
Person-owned, portable AI memory as a remote MCP server, readable and writable by any MCP client.
Persistent memory and cross-session learning for AI coding assistants (hosted remote MCP).
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/LeoYueDev/handsight'
If you have feedback or need assistance with the MCP directory API, please join our Discord server