AI駆動のセマンティックコード検索をMCPツールとして活用し、Windsurfの逆解析されたSWE-grepプロトコルによって駆動されます。

MCP互換クライアント(Claude Code、Claude Desktop、Cursorなど)は、自然言語クエリでコードベースを検索できます。すべてのツールはnpmでバンドルされており、*システムレベルの依存関係は不要(@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。

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.