Better Finder MCP

🔍 更好的查找器MCP

用于智能文件搜索和Claude MCP集成的类Git工作流

Better Finder通过语义搜索、混合匹配和熟悉的Git风格工作流来转换文件发现。为您的文档建立索引，使用自然语言进行搜索，并与Claude Desktop无缝集成。

🚀 快速开始

安装

# Clone and install
git clone https://github.com/GitHamza0206/better-finder-mcp.git
cd better-finder-mcp
uv venv
source .venv/bin/activate
pip install -e .

# Install it globally with uv
uv tool install -e .

基本工作流程

# 1. Stage files for indexing (like git add)
better-finder add ~/Documents

# 2. Check what's staged
better-finder status

# 3. Index staged files
better-finder index

# 4. Search your files
better-finder search "quarterly financial reports"

📋 命令

文件暂存

• `better-finder add

` -用于索引的阶段文件或文档

• `better-finder rm

` -从暂存中删除文件

• better-finder status -显示暂存文件
• better-finder index -索引暂存文件

搜索与管理

• better-finder search -搜索索引文件
• better-finder stats -显示索引统计信息
• better-finder clear-index -清除所有索引数据
• better-finder server -为Claude启动MCP服务器

公用事业

• better-finder show -显示文件内容
• better-finder remove-file -从索引中删除文件

🎯 主要特点

混合搜索

结合语义搜索、关键字匹配和模糊文件名搜索，以获得全面的结果。

类似Git的工作流

熟悉的暂存流程使您能够精确控制索引内容。

.beterfinderignore支持

使用忽略模式排除敏感文件：

# .betterfinderignore
secrets/
*.key
temp-*.pdf
node_modules/

支持的文件类型

• 文件：PDF、DOC、DOCX、TXT、MD、RTF、ODT
• 电子表格：XLSX、XLS、CSV、ODS
• 演示PPTX，PPT
• 数据：JSON、XML

Claude MCP集成

启动MCP服务器，直接在Claude Desktop中使用Better Finder：

better-finder server

添加到您的Claude桌面配置(~/.cursor/mcp.json):

{
  "mcpServers": {
    "better-finder": {
      "command": "better-finder",
      "args": ["server"]
    }
  }
}

🔧 配置

Better Finder使用智能默认值：

• 默认扫描路径: ~/Documents, ~/Desktop, ~/Downloads
• 忽略的目录: .git, node_modules, .venv，缓存文件夹
• 组块大小：2000个字符以获得更好的上下文
• 搜索阈值：综合结果为0.4

💡 例子

文档发现

# Find presentations about sales
better-finder search "sales presentation Q4"

# Look for specific file types
better-finder search "budget" --type excel

# Get more results
better-finder search "meeting notes" --max 20

暂存工作流

# Stage entire project documentation
better-finder add ./docs

# Remove sensitive files
better-finder rm ./docs/secrets/

# Check what will be indexed
better-finder status

# Index everything staged
better-finder index

MCP集成

服务器运行后，问Claude：

• “在我的文档中搜索预算报告”
• “查找有关项目时间表的演示文稿”
• “显示与客户提案相关的文件”

🏗️ 建筑

• 文件处理器：从不同格式中提取内容
• FAISS矢量商店：使用句子变换器进行快速相似性搜索
• SQLite元数据：高效的文件元数据和块存储
• 阶段系统：具有JSON持久性的类Git文件管理
• MCP服务器：Claude的模型上下文协议集成

📊 演出

• 索引：每分钟约100-500个文件
• 搜索：亚秒级结果
• 记忆：典型收藏约200-500MB
• 存储：每1000份文档约1-5MB

📝 许可证

MIT许可证-有关详细信息，请参阅许可证文件。

______________________________________________________________________

专为希望使用熟悉的类似Git的控件进行智能文件发现的开发人员而设计。