SD

sammysnake-d/fast-context-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

362 stars 54 forks 质量 85 趋势 27MIT

sammysnake-d/fast-context-mcp 是从 https://github.com/sammysnake-d/fast-context-mcp. 导入的 MCP 服务器候选

概览

sammysnake-d/fast-context-mcp 是从 https://github.com/sammysnake-d/fast-context-mcp. 导入的 MCP 服务器候选

概述(AI 翻译)

AI驱动的语义代码搜索作为MCP工具——由Windsurf逆向工程的SWE-grep协议驱动。

任何兼容MCP的客户端(Claude Code、Claude Desktop、Cursor等)都可以利用它通过自然语言查询搜索代码库。所有工具都通过npm捆绑——不需要系统级依赖(ripgrep通过@vscode/ripgrep,树通过tree-node-cli)。支持macOS、Windows和Linux。

工作原理

先修条件

  • Node.js >= 18
  • Windsurf账户 — 免费套餐可用(需要API密钥)

不需要安装 ripgrep——它是通过 @vscode/ripgrep 捆绑的。

安装

选项1:NPM(推荐)

选项2:来源

布置

1.获取你的Windsurf/Devin API密钥

服务器会自动从 Devin CLI/Desktop 或遗留的 Windsurf 安装中提取 API 密钥。你也可以在设置后使用 extract_windsurf_key MCP 工具,或者手动设置 WINDSURF_API_KEY。

桌面凭证的发现顺序如下:Devin,遗留的Deviv,然后是Windsurf。

站台 路径
macOS ~/Library/Application Support/Devin/User/globalStorage/state.vscdb
Windows %APPDATA%/Devin/User/globalStorage/state.vscdb

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Fast Context MCP

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

Any MCP-compatible client (Claude Code, Claude Desktop, Cursor, etc.) can use this to search codebases with natural language queries. All tools are bundled via npm — no system-level dependencies needed (ripgrep via @vscode/ripgrep, tree via tree-node-cli). Works on macOS, Windows, and Linux.

How It Works

You: "where is the authentication logic?"
         │
         ▼
┌─────────────────────────┐
│  Fast Context MCP       │
│  (local MCP server)     │
│                         │
│  1. Maps project → /codebase
│  2. Sends query to Windsurf Devstral API
│  3. AI generates rg/readfile/tree commands
│  4. Executes commands locally (built-in rg)
│  5. Returns results to AI
│  6. Repeats for N rounds
│  7. Returns file paths + line ranges
│     + suggested search keywords
└─────────────────────────┘
         │
         ▼
Found 3 relevant files.
  [1/3] /project/src/auth/handler.py (L10-60)
  [2/3] /project/src/middleware/jwt.py (L1-40)
  [3/3] /project/src/models/user.py (L20-80)

Suggested search keywords:
  authenticate, jwt.*verify, session.*token

Prerequisites

  • Node.js >= 18
  • Windsurf account — free tier works (needed for API key)

No need to install ripgrep — it’s bundled via @vscode/ripgrep.

Installation

# Latest stable release
npm install @sammysnake/fast-context-mcp

# Or beta/next release
npm install @sammysnake/fast-context-mcp@next

Option 2: From Source

git clone https://github.com/SammySnake-d/fast-context-mcp.git
cd fast-context-mcp
npm install

Setup

1. Get Your Windsurf/Devin API Key

The server auto-extracts the API key from Devin CLI/Desktop or a legacy Windsurf installation. You can also use the extract_windsurf_key MCP tool after setup, or set WINDSURF_API_KEY manually.

Desktop credentials are discovered in this order: Devin, legacy Deviv, then Windsurf.

Platform Path
macOS ~/Library/Application Support/Devin/User/globalStorage/state.vscdb
Windows %APPDATA%/Devin/User/globalStorage/state.vscdb
Linux ~/.config/Devin/User/globalStorage/state.vscdb
在 GitHub 查看完整 README

安装

npx -y --prefer-online @sammysnake/fast-context-mcp
新手?先看 mcpskill.org 教程 →