Sourcerer MCP

🚀 Sourcerer MCP 🧙

Sourcerer MCP是一个用于语义代码搜索和导航的MCP服务器，它能帮助AI代理高效工作，避免消耗大量昂贵的令牌。借助它，AI代理无需读取整个文件，就能进行概念性搜索，并直接跳转到所需的特定函数、类和代码块。

🚀 快速开始

若想快速体验Sourcerer MCP的功能，可参考以下各部分的操作说明。

✨ 主要特性

• 语义代码搜索与导航，帮助AI代理高效工作，减少令牌消耗。
• 支持概念性搜索，可直接跳转到特定代码块。
• 支持文件系统监控，自动重新索引更改的文件。
• 提供多种MCP工具，如语义搜索、获取源代码等。

📦 安装指南

Go安装

go install github.com/st3v3nmw/sourcerer-mcp/cmd/sourcerer@latest

Homebrew安装

brew tap st3v3nmw/tap
brew install st3v3nmw/tap/sourcerer

📚 详细文档

配置说明

Claude Code配置

claude mcp add sourcerer -e OPENAI_API_KEY=your-openai-api-key -e SOURCERER_WORKSPACE_ROOT=$(pwd) -- sourcerer

mcp.json配置

{
  "mcpServers": {
    "sourcerer": {
      "command": "sourcerer",
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "SOURCERER_WORKSPACE_ROOT": "/path/to/your/project"
      }
    }
  }
}

工作原理

Sourcerer会为你的代码库构建一个语义搜索索引，具体步骤如下：

1. 代码解析与分块

• 使用 Tree-sitter 将源文件解析为抽象语法树（AST）。
• 提取有意义的代码块（函数、类、方法、类型），并为其分配稳定的ID。
• 每个代码块包含源代码、位置信息和上下文摘要。
• 代码块ID遵循 file.ext::TypeName::methodName 的模式。

2. 文件系统集成

• 使用 fsnotify 监控文件更改。
• 通过 git check-ignore 遵循 .gitignore 文件规则。
• 自动重新索引更改的文件。
• 存储元数据以跟踪修改时间。

3. 向量数据库

• 使用 chromem-go 在 .sourcerer/db/ 中进行持久化向量存储。
• 通过OpenAI的API生成嵌入向量，以实现语义相似度搜索。
• 支持概念性搜索，而非仅文本匹配。
• 维护代码块、其嵌入向量和元数据。

4. MCP工具

• semantic_search：按概念/功能查找代码。
• get_source_code：按ID检索特定代码块。
• index_workspace：手动触发重新索引。
• get_index_status：检查索引进度。

这种方式使AI代理无需读取整个文件就能找到相关代码，显著减少了令牌使用和认知负担。

支持的语言

语言支持需要编写 Tree-sitter查询 来识别每种语言的函数、类、接口和其他代码结构。

• 已支持：Go
• 计划支持：Python、TypeScript、JavaScript

🤝 贡献代码

欢迎所有形式的贡献！

📺 演示

点击下面的链接查看演示：

⚙️ 系统要求

• OpenAI API密钥：生成嵌入向量时必需（计划支持本地嵌入）。
• Git：必须是git仓库（遵循 .gitignore 文件规则）。
• 将 .sourcerer/ 添加到 .gitignore：该目录用于存储嵌入向量数据库。