克劳德会话搜索
从Claude内部搜索您的Claude Code对话历史记录。
*“上周我们讨论了什么关于身份验证的问题？”* *“查找我们设置数据库的会话”* *“在我的历史记录中搜索语音框”*
Claude Code没有跨过去会话的内置搜索功能。这个MCP服务器添加了它——只需用自然语言询问Claude，它就会自动搜索您的本地对话历史记录。
设置（30秒）
1.安装
cd claude-session-search/mcp-server && npm install2.添加到Claude桌面配置
macOS — ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"session-search": {
"command": "node",
"args": ["/path/to/claude-session-search/mcp-server/index.mjs"]
}
}
}视窗 — %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"session-search": {
"command": "node",
"args": ["C:\\path\\to\\claude-session-search\\mcp-server\\index.mjs"]
}
}
}Linux — ~/.config/Claude/claude_desktop_config.json:
{
"mcpServers": {
"session-search": {
"command": "node",
"args": ["/path/to/claude-session-search/mcp-server/index.mjs"]
}
}
}3.重新启动克劳德桌面
就是这样。开始询问过去的会议。
你能做什么
搜索对话
问克劳德任何关于你过去的会议：
- “搜索我的会话以进行数据库迁移”
- “我们在哪个会议上讨论了API的重新设计？”
- “查找上周关于测试的对话”
克劳德打电话来 search_sessions 在幕后，返回带有上下文片段的排名结果。
列出最近的会话
- “显示我最近的会话”
- “我为网站项目安排了哪些会议？”
- “列出我最近的5个对话”
工具
| 工具 | 它做什么 |
|---|---|
search_sessions | 在所有会话中进行全文搜索。返回按与上下文片段的相关性排序的匹配项。 |
list_sessions | 列出按日期排序的会话，包括标题、项目和预览。 |
要尝试的事情
- 安装并重新启动Claude Desktop，然后问：“我们上周讨论了什么身份验证？” --MCP工具搜索所有JSONL会话文件，并返回按相关性排序的匹配片段。
- 询问“查找我们设置数据库的会话” --返回会话标题、项目和上下文摘录，这样您就可以在不打开任何文件的情况下识别正确的对话。
- 询问“列出我最近的10次会话” —
list_sessions返回按日期排序的会话，包括标题、项目名称和可扫描表中的预览。 - 搜索一个你知道出现在特定项目中的术语：“在舰队项目中查找提到语音框的会话” --结果范围包括将会话与显示术语出现位置的上下文行进行匹配。
- 验证隐私：打开
mcp-server/index.mjs并确认 --服务器是只读的，仅索引~/.claude/projects/，并且从不进行出站网络呼叫。
运作原理
Claude Code将每个对话存储为JSONL文件 ~/.claude/projects/。此MCP服务器读取这些文件，并将搜索结果作为Claude在您的对话中可以调用的工具公开。
~/.claude/projects/
my-project/
.jsonl ← full conversation transcript
another-project/
.jsonl一切都是本地的。没有数据离开你的机器。服务器是只读的，它从不修改您的会话文件。
需求
- Node.js 18+
- 克劳德桌面（macOS、Windows或Linux）
- 中现有的Claude Code会话
~/.claude/projects/
隐私
此工具仅读取本地磁盘上已有的文件(~/.claude/projects/).它不会：
- 将数据发送到任何外部服务
- 修改或删除任何文件
- 需要身份验证或API密钥
- 给家里打电话或收集遥测数据
另：会话恢复
崩溃或BSOD后丢失会话？结账 克劳德会话恢复 --一个配套工具，用于恢复在损坏事件后从Claude Desktop中消失的会话。
许可证
麻省理工学院