作者 Vvkmnn · Vvkmnn/claude-historian-mcp
搜索您自己的Claude Code历史记录—在没有单独索引的情况下查找过去的解决方案、错误、计划和会话。
claude-historian-mcp将本地~/.claude/conversations/视为可搜索语料库。两个工具：跨越11个范围（对话、错误、计划、配置、任务、会话、工具、类似查询、记忆…… ）的“搜索”查询，具有TF-IDF启发的评分、模糊匹配和工作流模式检测； “检查”通过完整UUID或短前缀返回任何会话的智能摘要。没有持久性索引—它根据需要并行处理项目。 使用它可以避免重新解决相同的错误、重复使用计划或显示半记住的命令。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"claude-historian-mcp": {
"command": "npx",
"args": [
"-y",
"claude-historian-mcp"
]
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"claude-historian-mcp": {
"command": "npx",
"args": [
"-y",
"claude-historian-mcp"
]
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"claude-historian-mcp": {
"command": "npx",
"args": [
"-y",
"claude-historian-mcp"
]
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"claude-historian-mcp": {
"command": "npx",
"args": [
"-y",
"claude-historian-mcp"
]
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "claude-historian-mcp",
"command": "npx",
"args": [
"-y",
"claude-historian-mcp"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"claude-historian-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"claude-historian-mcp"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add claude-historian-mcp -- npx -y claude-historian-mcp一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 你遇到了一个熟悉的错误；你想看看上次有什么效果。
结果： 几秒钟内的具体先例，而不是从头开始的重新调试。
何时使用： 新功能看起来就像您几个月前计划的那样—您想要找回骨架。
结果： 在不重新生成支架的情况下重复使用思维。
何时使用： 您开始对旧项目进行新的聊天，不想重新解释上下文。
结果： 新会话从最后一个有用的会话离开的地方开始。
促进对耐用内存的一次性修复
在代码图中记录历史学家的文本点击
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| search | query: str, scope: one-of (conversations|errors|plans|config|tasks|sessions|tools|similar|memories|…), limit?: int | 查找与您当前任务相关的先前对话 | 0 |
| inspect | session_id: str (full UUID or short prefix) | 获取单个会话的人工可读摘要 | 0 |
即使您知道对话存在，也没有结果尝试scope = 'conversations'并放松查询；检查~/.claude/conversations/不为空。
ls ~/.claude/conversations/ | head检查显示未找到短前缀的会话另一个会话以相同的前缀开始。使用更多字符。
Grep session IDs: grep -r -l '<prefix>' ~/.claude/conversations/在非常大的历史记录中速度很慢通过更窄的范围和限制；工具按需扫描，因此每个查询的庞大历史记录成本更高。
du -sh ~/.claude/conversations/| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| memory-bank-mcp | 您需要精心策划的项目范围内存，而不是原始历史记录搜索 | 必须填充；而不是自由格式检索 |
| codebase-memory | 您想要代码的符号图，而不是对话搜索 | 不同层次 |
| filesystem | 您宁愿自己与grep对话 | 丢失评分、模糊匹配和会话摘要 |