Claude Grep

克劳德·格雷普

类似Grep的工具，用于搜索Claude对话历史记录，具有强大的过滤功能、多种输出格式和项目感知上下文。

Claude Grep Web UI

特性

• 综合搜索：按关键字、文件、错误或模式查找对话
• 多种输出格式：表格、列表、CSV、markdown、JSON
• 项目上下文：自动将搜索限制到当前项目
• 钻取能力：查看带有上下文的完整对话
• 耗尽模式：优先考虑完整性的深度搜索
• MCP集成：与Claude Desktop无缝协作

安装

NPM（推荐）

npm install -g claude-grep

来源

git clone https://github.com/iamneilroberts/claude-grep.git
cd claude-grep
npm install
npm run build
npm link

MCP（模型上下文协议）配置

claude-grep通过MCP与claude Desktop集成，允许您直接在claude中搜索对话。

为Claude Desktop设置MCP

1. 打开克劳德桌面设置

- 在 macOS 上： Claude → Settings → Developer → Edit Config - 在Windows上： File → Preferences → Developer → Edit Config

1. 将claude grep添加到您的MCP设置中：

{
  "mcpServers": {
    "claude-grep": {
      "command": "npx",
      "args": ["claude-grep", "mcp"]
    }
  }
}

1. 重新启动克劳德桌面 以使更改生效。

替代MCP配置（本地安装）

如果您是从源代码安装的，或者想使用特定的安装：

{
  "mcpServers": {
    "claude-grep": {
      "command": "node",
      "args": ["/path/to/claude-grep/dist/mcp/server.js"]
    }
  }
}

在claude Desktop中使用claude grep

配置后，您可以使用自然语言搜索您的对话：

• “搜索有关TypeScript错误的对话”
• “查找我们讨论身份验证系统的位置”
• “显示提及package.json的对话”
• “将对话abc123导出到文件”

MCP集成提供了以下工具：

• search_conversations -使用关键字搜索
• search_for_files -查找提及特定文件的对话
• get_conversation_details -查看完整对话
• export_conversation -将对话导出到文件（非常适合Claude的紧凑视图）
• list_projects -查看您的所有项目
• switch_project -更改活动项目

快速开始

CLI使用情况

# Search for a keyword
claude-grep search "TypeError"

# Search with table output (default)
claude-grep search "async function" --format table

# Search in specific project
claude-grep search "bug fix" --project my-project

# Exhaustive search (slower but complete)
claude-grep search "edge case" --exhaustive

CLI Table Output

在克劳德桌面

MCP设置后，在Claude中使用以下命令：

• 搜索：“搜索有关TypeScript错误的对话”
• 文件：“查找上次编辑package.json的时间”
• 深入分析：“向我展示关于该bug修复的完整对话”

输出格式

表格格式（默认）

Session               Time          Match Preview                    Files
4dK92La_conversati... 17 hours ago  ...dealing with TypeScript err... src/types.ts, src/index.ts
9mN31Pb_conversati... 2 days ago    ...fixed the async/await issue... lib/async.js

列表格式

1. Session 4dK92La (17 hours ago)
   Files: src/types.ts, src/index.ts
   Match: "...when dealing with TypeScript errors in the..."
   
2. Session 9mN31Pb (2 days ago)
   Files: lib/async.js
   Match: "...successfully fixed the async/await issue by..."

高级用法

Web用户界面

启动可视化搜索的web界面：

# Start web server on default port (3000)
claude-grep web

# Start on custom port
claude-grep web --port 8080

# Start without opening browser
claude-grep web --no-open

web界面提供：

• 实时搜索实时结果
• 项目切换
• 使用对话内搜索深入了解对话
• 支持多种输出格式
• 受克劳德启发的黑暗主题

Web UI Search Results

安全说明：web服务器仅设计用于本地使用。你的对话数据永远不会离开你的机器。不要将web服务器暴露在互联网上，因为它不包括身份验证。

持久首选项

设置默认输出格式：

claude-grep config set format markdown

发展

# Clone the repository
git clone https://github.com/iamneilroberts/claude-grep.git
cd claude-grep

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

故障排除

MCP连接问题

如果claude grep在claude Desktop中不工作：

1. 检查配置路径

- 确保配置文件保存在正确的位置 - 常见位置： - macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 验证安装

   # Check if claude-grep is installed globally
   npm list -g claude-grep

   # Test MCP server directly
   npx claude-grep mcp

1. 检查克劳德桌面日志

- 在Claude Desktop中打开开发人员工具 - 在控制台中查找与MCP相关的错误

1. 常见修复

- 配置更改后重新启动Claude Desktop - 确保您拥有最新版本的claude grep - 检查Node.js是否在您的系统PATH中

权限问题

如果遇到权限错误：

# On macOS/Linux
sudo npm install -g claude-grep

# Or use a Node version manager like nvm
nvm use 18
npm install -g claude-grep

许可证

麻省理工学院