Wisdom Store

智慧商店

一个MCP服务器，为AI编码助手提供持久记忆、上下文控制和抗幻觉工具。

提前释放 --积极开发，API可能会发生变化。预计会有粗糙的边缘。

它做什么

上下文控制 --实时修剪对话上下文（无需重新启动），将精心策划的知识注入会话，监控上下文使用情况。

持久的知识 --将课程、模式、注意事项和边缘案例保存到跨会话的平面文件中。按项目部分、文件或全局组织。

项目索引 --基于AST的符号提取（通过 @astgrep/napi)，API路由检测，HTML页面清单。生成一个紧凑的项目概述，旨在为Claude提供一个详细的项目地图，用于您的上下文窗口的一小部分。

抗幻觉 --具有模糊匹配的符号注册表可以捕获幻觉函数名、拼写错误和未知符号。包括一个写后挂钩，每次编辑后都会自动警告幻觉导入、文件路径、函数调用和API路由。

工具（11）

上下文控制

持久知识

项目索引

抗幻觉

安装

git clone https://github.com/InfiniQuest-App/wisdom-store.git
cd wisdom-store
npm install

添加到您的 ~/.claude.json 或项目 .mcp.json （参见 examples/mcp.json):

{
  "mcpServers": {
    "wisdom-store": {
      "command": "node",
      "args": ["/path/to/wisdom-store/src/mcp-server/index.js"],
      "env": {}
    }
  }
}

重新启动Claude Code或运行 /mcp 连接。

教克劳德使用它

从以下位置复制相关章节 examples/CLAUDE.md 进入你的项目 CLAUDE.md这教会了克劳德何时加载智慧、保存知识、检查符号和管理上下文。

钩子

这 hooks/ 该目录包含自动与智慧存储集成的Claude Code挂钩。

添加到您的设置文件-- ~/.claude/settings.json （全球）， .claude/settings.json （项目），或 .claude/settings.local.json （每个项目个人）。替换 /path/to/wisdom-store 使用您的实际克隆路径。

写作后幻觉检查

每次写入/编辑后自动检查幻觉：

• 导入指向不存在文件的路径
• 导入的符号不在项目注册表中
• 对未知符号的独立函数调用
• 在项目索引中找不到API路由

需要 .wisdom/symbols.json --奔跑 get_project_overview 生成一次（每次调用时自动刷新）。仅对代码文件开火(.js, .ts, .py, .go, .rs).

预压缩保存提醒

提醒克劳德在压缩上下文之前将重要发现保存到智慧库中。手动和手动都着火了(/compact)以及自动压实。仅在具有以下条件的项目中发生火灾 .wisdom/ 目录。

设置

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [{
          "type": "command",
          "command": "/path/to/wisdom-store/hooks/post-write-symbol-check.sh",
          "timeout": 10
        }]
      },
      {
        "matcher": "Write",
        "hooks": [{
          "type": "command",
          "command": "/path/to/wisdom-store/hooks/post-write-symbol-check.sh",
          "timeout": 10
        }]
      }
    ],
    "PreCompact": [
      {
        "matcher": "",
        "hooks": [{
          "type": "command",
          "command": "/path/to/wisdom-store/hooks/pre-compact-save-reminder.sh",
          "timeout": 10
        }]
      }
    ]
  }
}

运作原理

存储

一切都是平面文件 .wisdom/ 项目根目录：

.wisdom/
  index.json           # Project metadata + file list
  symbols.json         # Symbol registry (functions, classes, exports, routes)
  sections/            # Knowledge organized by topic
    auth.md
    estimates.md
  plans/               # Feature plans
    v2-migration.md
  patterns/            # Reusable patterns
    error-handling.md

智慧储存在三个层面：

• 项目 — .wisdom/sections/, .wisdom/plans/, .wisdom/patterns/ 了解这个项目
• 文件特定 --源旁边的Sidecar文件： myfile.js 获取 myfile.js.wisdom
• 全球 — ~/.claude/wisdom/ 用于跨项目课程（使用 scope: "global" 随着 save_wisdom)

上下文操纵

prune_context 通过设置工作 parentUuid: null 在JSONL对话文件中的目标消息上，孤立它之前的所有内容。这在下一条消息上生效——不需要重新启动。

inject_context 附加一条新消息 parentUuid: null 就像一根新鲜的根。需要 /resume 重新加载。辅助脚本(hooks/send-resume.sh)作为tmux自动化的起点，但手动 /resume 是最可靠的方法。

AST提取

用途 @ast-grep/napi （基于树的）JavaScript/TypeScript/TSX。提取函数、类、变量、导出、接口、类型、枚举。正则表达式在Python、Go和Rust中的回退。

项目概述旨在提高上下文效率——足够紧凑，可以容纳单个工具响应，同时涵盖文件树、符号、路线和页面。

输出示例

跑步 get_project_overview 关于此回购：

# Project Overview

## Files (16)
Total: 3,093 lines

- hooks/: symbol-check.mjs (273L)
- src/mcp-server/: index.js (371L)
- src/mcp-server/lib/: indexer.js (643L), jsonl.js (276L), wisdom.js (325L)
- src/mcp-server/tools/: check-symbols.js (87L), context-status.js (123L),
    get-project-overview.js (58L), get-wisdom.js (179L), inject-context.js (177L),
    list-wisdom.js (144L), prune-context.js (125L), refresh-symbols.js (15L),
    reindex-project.js (92L), save-wisdom.js (106L), update-plan.js (99L)

## Symbols
Functions: 62, Classes/Types: 0, Exports: 40

### Exports
- appendLine — src/mcp-server/lib/jsonl.js:273
- checkSymbols — src/mcp-server/lib/indexer.js:543
- findConversationFile — src/mcp-server/lib/jsonl.js:30
- generateOverview — src/mcp-server/lib/indexer.js:450
- handleCheckSymbols — src/mcp-server/tools/check-symbols.js:24
- handlePruneContext — src/mcp-server/tools/prune-context.js:23
- scanProject — src/mcp-server/lib/indexer.js:50
- walkChain — src/mcp-server/lib/jsonl.js:160
  ... (40 exports total)

典型工作流程

1. Start working on a task
2. get_project_overview → understand the codebase
3. get_wisdom for relevant files/sections → load past knowledge
4. Work on the task
5. save_wisdom to persist new insights
6. check_symbols after writing code → catch hallucinations
7. If context gets large: save_wisdom → prune_context → continue

语言支持

需求

• Node.js 18+
• Claude代码（用于MCP集成和挂钩）

许可证

麻省理工学院