de en es ja ko ru zh

Fast Context MCP

Name: Fast Context MCP
Author: SammySnake-d

by SammySnake-d

Overview Schema Related Servers Score Discussions

JavaScript

Local

Fast Context MCP

AI 기반 시맨틱 코드 검색 MCP 도구 — Windsurf의 리버스 엔지니어링된 SWE-grep 프로토콜을 기반으로 합니다.

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

작동 방식

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

Related MCP server: code-rag

사전 요구 사항

Node.js >= 18
Windsurf 계정 — 무료 티어로 충분합니다 (API 키 필요)

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

설치

방법 1: npm (권장)

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

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

방법 2: 소스에서

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

설정

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`
Linux	`~/.config/Devin/User/globalStorage/state.vscdb`

WSL/Linux에서 서버는 먼저 ~/.local/share/devin/credentials.toml의 Devin CLI 자격 증명을 확인합니다. Windows에서 추출한 키가 WSL 내부에서 403을 반환하면 WSL에서 devin login을 실행하고 다시 시도하세요.

2. MCP 클라이언트 구성

Claude Code

mcpServers 아래의 ~/.claude.json에 추가하세요:

{
  "fast-context": {
    "command": "npx",
    "args": ["-y", "--prefer-online", "@sammysnake/fast-context-mcp"],
    "env": {
      "WINDSURF_API_KEY": "sk-ws-01-xxxxx"
    }
  }
}

베타/다음 릴리스의 경우:

{
  "fast-context": {
    "command": "npx",
    "args": ["-y", "--prefer-online", "@sammysnake/fast-context-mcp@next"],
    "env": {
      "WINDSURF_API_KEY": "sk-ws-01-xxxxx"
    }
  }
}

Claude Desktop

mcpServers 아래의 claude_desktop_config.json에 추가하세요:

{
  "fast-context": {
    "command": "npx",
    "args": ["-y", "--prefer-online", "@sammysnake/fast-context-mcp"],
    "env": {
      "WINDSURF_API_KEY": "sk-ws-01-xxxxx"
    }
  }
}

베타/다음 릴리스의 경우:

{
  "fast-context": {
    "command": "npx",
    "args": ["-y", "--prefer-online", "@sammysnake/fast-context-mcp@next"],
    "env": {
      "WINDSURF_API_KEY": "sk-ws-01-xxxxx"
    }
  }
}

WINDSURF_API_KEY가 생략되면 서버가 로컬 Windsurf 설치에서 자동으로 발견합니다.

환경 변수

변수	기본값	설명
`WINDSURF_API_KEY`	(자동 발견)	Windsurf API 키
`FC_MAX_TURNS`	`3`	쿼리당 검색 라운드 수 (많을수록 더 깊지만 느림)
`FC_MAX_COMMANDS`	`8`	라운드당 최대 병렬 명령 수
`FC_TIMEOUT_MS`	`30000`	스트리밍 요청에 대한 연결 제한 시간(ms)
`FC_HIDE_EXTRACT_WINDSURF_KEY_TOOL`	`false`	`1`, `true`, `yes`, `on`으로 설정하면 MCP 도구에서 `extract_windsurf_key`를 숨깁니다
`FC_RESULT_MAX_LINES`	`50`	명령 출력당 최대 줄 수 (잘림)
`FC_LINE_MAX_CHARS`	`250`	출력 줄당 최대 문자 수 (잘림)
`FC_CACHE_DISABLED`	(설정 안 됨)	`1`, `true`, `yes`, `on`으로 메모리 내 결과 캐시를 비활성화합니다
`FC_CACHE_TTL_MS`	`300000`	결과 캐시 TTL; `<=0`이면 캐싱 비활성화
`FC_CACHE_MAX_ENTRIES`	`200`	메모리 내 캐시 최대 항목 수
`FC_ALLOW_INSECURE_TLS`	(설정 안 됨)	신뢰할 수 있는 기업 프록시가 TLS 검증 비활성화를 요구하는 경우에만 `1`로 설정하세요
`WS_MODEL`	`MODEL_SWE_1_6_FAST`	Windsurf 모델 이름
`WS_APP_VER`	`1.48.2`	Windsurf 앱 버전 (프로토콜 메타데이터)
`WS_LS_VER`	`1.9544.35`	Windsurf 언어 서버 버전 (프로토콜 메타데이터)

사용 가능한 모델

WS_MODEL을 설정하여 모델을 변경할 수 있습니다 (위 환경 변수 참조).

사용 가능한 모델

기본값: MODEL_SWE_1_6_FAST — 가장 빠른 속도, 가장 풍부한 grep 키워드, 가장 세밀한 위치 정밀도.

MCP 도구

`fast_context_search`

조정 가능한 매개변수를 갖춘 AI 기반 시맨틱 코드 검색.

매개변수	유형	필수	기본값	설명
`query`	string	예	—	자연어 검색 쿼리
`project_path`	string	아니요	cwd	프로젝트 루트의 절대 경로
`tree_depth`	integer	아니요	`3`	저장소 맵을 위한 디렉터리 트리 깊이 (1-6). 높을수록 더 많은 컨텍스트를 제공하지만 페이로드가 커집니다. 트리가 250KB를 초과하면 자동으로 더 낮은 깊이로 폴백합니다. 대규모 모노레포(>5000개 파일)에는 1-2, 대부분의 프로젝트에는 3, 소규모 프로젝트에는 4-6을 사용하세요.
`max_turns`	integer	아니요	`3`	검색 라운드 (1-5). 많을수록 더 깊게 검색하지만 느립니다. 단순 조회에는 1-2, 대부분의 쿼리에는 3, 복잡한 분석에는 4-5를 사용하세요.
`max_results`	integer	아니요	`10`	반환할 최대 파일 수 (1-30). 작을수록 더 집중되고, 클수록 더 광범위하게 탐색합니다.
`exclude_paths`	string[]	아니요	`[]`	저장소 맵과 검색 컨텍스트에서 제외되는 디렉터리/파일 패턴.

반환:

관련 파일 (줄 범위 포함)
제안된 검색 키워드 (AI 검색 중 사용된 rg 패턴)
진단 메타데이터 ([config] 줄에 실제 사용된 tree_depth, 트리 크기, 폴백 발생 여부 표시)

예제 출력:

Found 3 relevant files.

  [1/3] /project/src/auth/handler.py (L10-60, L120-180)
  [2/3] /project/src/middleware/jwt.py (L1-40)
  [3/3] /project/src/models/user.py (L20-80)

grep keywords: authenticate, jwt.*verify, session.*token

[config] tree_depth=3, tree_size=12.5KB, max_turns=3

오류 출력에는 상태별 힌트가 포함됩니다:

Error: Request failed: HTTP 403

[hint] 403 Forbidden: Authentication failed. The API key may be expired or revoked.
Try re-extracting with extract_windsurf_key, or set a fresh WINDSURF_API_KEY env var.
If you are running inside WSL, run `devin login` inside WSL so `~/.local/share/devin/credentials.toml` exists.

Error: Request failed: HTTP 413

[diagnostic] tree_depth_used=3, tree_size=280.0KB (auto fell back from requested depth)
[hint] If the error is payload-related, try a lower tree_depth value.

`extract_windsurf_key`

로컬 설치에서 Windsurf API 키를 추출합니다. 매개변수가 없습니다.

MCP 서버 시작 시 FC_HIDE_EXTRACT_WINDSURF_KEY_TOOL=1로 설정하면 tools/list에서 이 도구를 숨깁니다. 이것은 fast_context_search의 내부 API 키 자동 발견을 비활성화하지 않습니다.

프로젝트 구조

fast-context-mcp/
├── package.json
├── src/
│   ├── server.mjs        # MCP server entry point
│   ├── core.mjs          # Auth, message building, streaming, search loop
│   ├── executor.mjs      # Tool executor: rg, readfile, tree, ls, glob
│   ├── extract-key.mjs   # Windsurf API Key extraction (SQLite)
│   ├── path-safety.mjs   # Project-root confinement for model-selected paths
│   ├── response-repair.mjs # Malformed response repair and evidence salvage
│   ├── shared.mjs        # Repository map, answer parser, prompt builder
│   ├── cache.mjs         # In-memory search-result cache
│   └── protobuf.mjs      # Protobuf encoder/decoder + Connect-RPC frames
├── test/                 # Unit and MCP stdio integration tests
├── README.md
└── LICENSE

검색 작동 방식

프로젝트 디렉터리가 가상 /codebase 경로에 매핑됩니다
요청된 깊이(기본 L=3)로 디렉터리 트리가 생성되며, 트리가 250KB를 초과하면 자동 폴백으로 더 낮은 깊이가 사용됩니다
쿼리와 디렉터리 트리가 Connect-RPC/Protobuf를 통해 Windsurf의 Devstral 모델로 전송됩니다
Devstral이 도구 명령(ripgrep, 파일 읽기, tree, ls, glob)을 생성합니다
명령이 로컬에서 병렬로 실행됩니다 (라운드당 최대 FC_MAX_COMMANDS)
결과가 다음 라운드를 위해 Devstral로 다시 전송됩니다
max_turns 라운드 후 Devstral이 파일 경로와 줄 범위를 반환합니다
검색 중 사용된 모든 rg 패턴이 제안된 키워드로 수집됩니다
호출 AI가 매개변수를 조정할 수 있도록 진단 메타데이터가 추가됩니다

기술 세부 사항

프로토콜: HTTP/1.1을 통한 Connect-RPC, Protobuf 인코딩, gzip 압축
모델: Devstral (MODEL_SWE_1_6_FAST, 구성 가능)
로컬 도구: rg (@vscode/ripgrep을 통해 번들), readfile (Node.js fs), tree (tree-node-cli), ls (Node.js fs), glob (Node.js fs)
인증: API 키 → JWT (세션별 자동 가져오기)
런타임: Node.js >= 18 (ESM)

의존성

패키지	용도
`@modelcontextprotocol/sdk`	MCP 서버 프레임워크
`@vscode/ripgrep`	번들된 ripgrep 바이너리 (크로스 플랫폼)
`tree-node-cli`	크로스 플랫폼 디렉터리 트리 (시스템 `tree` 대체)
`sql.js`	네이티브 빌드 단계 없이 Devin/Windsurf의 로컬 SQLite DB를 읽습니다
`zod` (`^3.25.76`)	스키마 검증; 일부 npm 미러가 제공하는 불완전한 `3.25.0` tarball을 피합니다

라이선스

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

3dResponse time

8wRelease cycle

4Releases (12mo)

Commit activity

Issues opened vs closed

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

Fast Context MCP
Code Analysis Search Developer Tools
TripQi
A
license
A
quality
D
maintenance
Enables AI-driven semantic code search using Windsurf's reverse-engineered SWE-grep protocol to query local codebases with natural language. It executes local search tools like ripgrep and tree-node-cli to return relevant file paths and line ranges to MCP-compatible clients.
Updated 6 months ago (2026-02-23 00:58 UTC)
2
227
MIT
code-rag
RAG Systems Search Code Analysis
kkuppula
F
license
Not graded
quality
C
maintenance
A semantic code search MCP server that enables natural language queries against your codebase, supporting features like related file discovery and context expansion, all running locally.
Updated 3 months ago (2026-05-26 17:33 UTC)
2
embecode
Code Analysis Developer Tools Search
jdtzmn
A
license
A
quality
D
maintenance
Local-first MCP server for semantic + keyword hybrid code search. Zero external services, no API keys required.
Updated 6 months ago (2026-02-27 19:55 UTC)
2
MIT
VecGrep
Code Analysis Search Developer Tools
VecGrep
A
license
Not graded
quality
A
maintenance
Semantic code search MCP server that reduces token usage by ~95% by returning top relevant code chunks instead of full files.
Updated 2 months ago (2026-06-09 08:16 UTC)
9
MIT

View all related MCP servers

Related MCP Connectors

LLMemory
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
gread
An MCP server that gives your AI access to the source code and docs of all public github repos
driflyte-mcp-server
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SammySnake-d/fast-context-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Fast Context MCP

작동 방식

사전 요구 사항

설치

방법 1: npm (권장)

방법 2: 소스에서

설정

1. Windsurf/Devin API 키 가져오기

2. MCP 클라이언트 구성

Claude Code

Claude Desktop

환경 변수

사용 가능한 모델

MCP 도구

fast_context_search

extract_windsurf_key

프로젝트 구조

검색 작동 방식

기술 세부 사항

의존성

관련 링크

라이선스

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Fast Context MCP

code-rag

embecode

VecGrep

Related MCP Connectors

Latest Blog Posts

MCP directory API

`fast_context_search`

`extract_windsurf_key`