AI 기반 의미 코드 검색을 MCP 도구로 활용하며, Windsurf의 역설계된 SWE-grep 프로토콜로 구동됩니다.

모든 MCP 호환 클라이언트(Claude Code, Claude Desktop, Cursor 등)는 자연어 쿼리가 포함된 코드베이스를 검색할 수 있습니다. 모든 도구는 npm을 통해 번들로 제공되며, **시스템 수준의 의존성이 필요 없습니다(@vscode/ripgrep를 통한 ripgrep, tree-node-cli를 통한 트리). macOS, Windows, Linux에서 작동합니다.

작동 원리

선수 조건

• Node.js >= 18
• Windsurf 계정 — 무료 티어 사용 (API 키 필요)

ripgrep을 설치할 필요는 없습니다 — @vscode/ripgrep로 번들로 제공됩니다.

설치

옵션 1: npm (추천)

옵션 2: 출처에서

준비

1. 윈드서프/Devin API 키를 받으세요

서버는 Devin CLI/Desktop 또는 레거시 Windsurf 설치에서 API 키를 자동으로 추출합니다. 설정 후 extract_windsurf_key MCP 도구를 사용하거나 WINDSURF_API_KEY를 수동으로 설정할 수도 있습니다.

데스크톱 자격 증명은 Devin, 레거시 Deviv, 그리고 Windsurf의 순서로 발견됩니다.

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

Option 1: npm (Recommended)

# 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.