SammySnake-d/fast-context-mcp

AI-driven semantic code search as an MCP tool — powered by Windsurf's reverse-engineered SWE-grep protocol

What it solves

它使 AI 客户端（如 Claude Code、Cursor 或 Claude Desktop）能够使用自然语言查询在本地代码库中进行语义代码搜索。它弥补了用户的高层级问题与相关逻辑所在的特定文件和行范围之间的鸿沟，从而消除了用户手动使用 grep 或浏览目录的需要。

How it works

该项目作为一个 Model Context Protocol (MCP) 服务器，利用了 Windsurf 的 Devstral API。当接收到查询时，服务器会映射本地项目目录并生成目录树。此上下文连同查询一起发送给 Devstral 模型，该模型随后会生成一系列本地命令（例如 ripgrep、文件读取和 glob 搜索）。这些命令在用户的机器上本地执行，并将结果通过多轮优化反馈给 AI，直到识别出最相关的文件路径和行范围。

Who it’s for

使用 MCP 兼容的 AI 编程助手并希望拥有一种更强大、由 AI 驱动的方式来导航和搜索本地源代码，而不依赖于基础关键词匹配的开发者。

Highlights

Zero System Dependencies: Bundles ripgrep and tree via npm，确保它可以在 macOS、Windows 和 Linux 上运行，而无需手动安装。
Semantic Search: 使用 AI 模型迭代地搜索并优化结果，而不是简单的字符串匹配。
Automatic Context Management: 自动调整目录树深度，以防止超出有效载荷大小限制。
Auto-Discovery of Credentials: 可以自动从本地 Windsurf 或 Devin 安装中提取 API 密钥。