mcpField
C
claude-find

claude-find

本地服务
github.com/Cavinooo记忆与知识1220 周前更新
代码仓库

关于 claude-find

claude-find 是用于检索 Claude Code 历史会话的语义与关键词搜索工具。它索引原始对话记录和工具调用元数据，帮助开发者找回先前的推理、决策、错误和文件操作，而不依赖压缩摘要。

主要功能

  1. 01语义与关键词搜索
  2. 02索引原始会话记录
  3. 03纳入工具调用元数据
  4. 04后台索引会话
  5. 05返回原始对话片段

适用场景

  1. 01找回先前讨论的数据库迁移
  2. 02查明某项设计决策的原因
  3. 03定位出现重复错误的会话
  4. 04跨项目搜索过往工作

MCP 相关

设置过程会将 claude-find 注册为 Claude Code 的 MCP 服务。README 未说明其 MCP 工具或协议行为。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cavinooo-claude-find": {
      "command": "npx",
      "args": [
        "-y",
        "claude-find"
      ]
    }
  }
}
启动命令npx -y claude-find

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmclaude-find0.2.5

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

claude-find

按需从所有 Claude Code 会话中检索深层记忆。

演示

对你过去所有 Claude Code 会话进行语义搜索。按含义和关键词查找上下文。搜索原始对话记录，而非压缩后的摘要，因此 Claude 能全面了解情况：推理过程、约束、失败的方案和决策。

设置

brew install bun ollama
bunx claude-find setup

setup 会启动 Ollama、拉取嵌入模型、将会话保留期限设为永久，并在 Claude Code 中注册 MCP 服务。启动时会在后台为会话建立索引。搜索可以立即使用；随着索引继续建立，搜索结果也会逐步变得更完整。

Linux / Windows

安装 Bun 和 Ollama，然后运行 bunx claude-find setup。它会检测你的平台，并引导你完成缺少的步骤。

使用方法

在任意 Claude Code 会话中：

/find that database migration we discussed last week
/find why we chose websockets over polling
/find the session where we kept getting timeout errors
/find refactoring the payment module across all projects

Claude 会对你过去的会话进行语义搜索，找到相关对话，并综合上下文：尝试过什么、哪些方案失败、你设定了哪些约束，以及做出了哪些决策。

工作原理

  1. 建立索引：索引 ~/.claude/projects/ 中所有 Claude Code 会话 JSONL 文件
  2. 提取：提取用户和助手消息、精简摘要，以及工具调用中的文件路径
  3. 丰富：为每个文本块添加元数据上下文（项目、分支、文件、日期），以改进检索效果
  4. 生成嵌入：通过 Ollama 使用 qwen3-embedding 为对话文本块生成嵌入（由 GPU 加速）
  5. 搜索：结合语义搜索与关键词搜索（FTS5），并通过 Reciprocal Rank Fusion 合并结果
  6. 返回：返回原始对话文本块，让 Claude 能结合完整上下文进行综合

升级后，运行 bunx claude-find index，使用最新改进重建索引。

与众不同之处

  • 搜索原始对话记录。不会因压缩而丢失信息。
  • 追溯索引：立即支持所有现有会话，无需钩子。
  • 永久保留历史记录：设置时会禁用 Claude Code 的 30 天会话清理功能，让你的会话永久可搜索。
  • 非阻塞：启动时在后台建立索引。即使索引尚未完成，搜索也能立即使用。
  • 使用精简摘要：将 Claude 对会话的理解纳入搜索，并提高其排名。
  • 索引工具调用元数据：可按涉及的文件和遇到的错误进行搜索。
  • 快速：Ollama + GPU 让索引速度快且内存占用有界。

要求

  • Bun 运行时
  • Ollama（首次使用时会自动下载模型）
  • Claude Code

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。