shebe

概述

Shebe 是一款高性能的本地代码搜索工具，使用 BM25 算法而非嵌入或 GPU 加速。它提供快速索引（每秒 2k-12k 文件）和 2ms 查询延迟，并完全支持 UTF-8。该项目包含 14 个专门为编程代理设计的 MCP 工具，用于执行查找引用、搜索代码和分析代码库等任务。它被定位为 Serena MCP 等结构化工具的补充，为大型多语言代码库提供排名搜索功能。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• find_references

  Find all references to a symbol in the codebase

  试试:Find all references to SubstitutionFormatter试试:Show me all usages of the login function
• search_code

  Search for code patterns across the repository

  试试:Search for access log formatting试试:Find all implementations of the authentication API
• index_repository

  Index a repository for code search

  试试:Index the ~/envoy repository试试:Prepare my project directory for searching
• find_file

  Find files by pattern in the repository

  试试:Find all test files related to authentication试试:Show me all configuration files
• read_file

  Read the complete contents of a file

  试试:Show me the full content of utils.py试试:Read the authentication module
• preview_chunk

  Preview a file with context around a specific match

  试试:Show me the context around the login function试试:Preview the code around this error
• reindex_session

  Update an existing index with new files

  试试:Reindex my session to include new files试试:Update the index with recent changes
• list_sessions

  List all available indexed repositories

  试试:Show me all my indexed repositories试试:List available sessions
• get_session_info

  Get information about a specific indexed repository

  试试:Show me details about the envoy index试试:Tell me about my current session
• upgrade_session

  Upgrade an older session to the latest schema

  试试:Upgrade my old session试试:Fix schema version mismatch
• list_dir

  List files in a directory with matching pattern

  试试:Show me all test files in this directory试试:List all Python files in the project
• delete_session

  Delete an indexed repository

  试试:Remove the envoy index from my sessions试试:Delete my old session

说明：Tool names extracted from the table and text references, but detailed documentation is in a separate file not provided here.

可对比工具

安装

brew tap shebe-oss/tap
brew install shebe

export SHEBE_VERSION=v0.5.8
curl -LO "https://github.com/shebe-oss/shebe-releases/releases/download/${SHEBE_VERSION}/shebe-${SHEBE_VERSION}-linux-x86_64.tar.gz"
curl -LO "https://github.com/shebe-oss/shebe-releases/releases/download/${SHEBE_VERSION}/shebe-${SHEBE_VERSION}-linux-x86_64.tar.gz.sha256"
sha256sum -c shebe-${SHEBE_VERSION}-linux-x86_64.tar.gz.sha256
tar -xzf shebe-${SHEBE_VERSION}-linux-x86_64.tar.gz
sudo mv shebe shebe-mcp /usr/local/bin/

{
  "mcpServers": {
    "shebe": {
      "command": "shebe-mcp",
      "args": []
    }
  }
}

FAQ

Shebe 与其他代码搜索工具有何不同？

Shebe 使用 BM25 算法而非嵌入或 GPU 加速，使其速度极快且资源需求低。它提供排名结果，专为大型代码库优化，查询延迟为 2ms。

Shebe 是否支持远程代码库？

不支持，代码库必须在索引前克隆到本地。这是为了速度和隐私所做的权衡，因为在搜索操作期间不需要网络访问。

shebe 对比