### Install Fast Context MCP from Source

Source: https://github.com/sammysnake-d/fast-context-mcp/blob/main/README.md

Follow these steps to clone the repository and install Fast Context MCP directly from its source code. This is useful for development or if you need to modify the code.

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

--------------------------------

### Install Latest Stable Fast Context MCP

Source: https://github.com/sammysnake-d/fast-context-mcp/blob/main/README.md

Use this command to install the latest stable release of the Fast Context MCP package via npm. This is the recommended installation method.

```bash
npm install @sammysnake/fast-context-mcp
```

--------------------------------

### Install Beta/Next Fast Context MCP Release

Source: https://github.com/sammysnake-d/fast-context-mcp/blob/main/README.md

Use this command to install the beta or next release of the Fast Context MCP package via npm. This allows access to the latest features and potential bug fixes before they are in the stable release.

```bash
npm install @sammysnake/fast-context-mcp@next
```

--------------------------------

### Fast Context Search Example Output

Source: https://github.com/sammysnake-d/fast-context-mcp/blob/main/README.md

Illustrates the expected output format for a successful semantic code search, including relevant files, line ranges, suggested keywords, and diagnostic metadata.

```text
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
```

--------------------------------

### Fast Context Search Error Output (403 Forbidden)

Source: https://github.com/sammysnake-d/fast-context-mcp/blob/main/README.md

Shows an example of an HTTP 403 Forbidden error during a request, including diagnostic hints for authentication issues and potential solutions.

```text
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.
```

--------------------------------

### Fast Context Search Error Output (413 Payload Too Large)

Source: https://github.com/sammysnake-d/fast-context-mcp/blob/main/README.md

Displays an example of an HTTP 413 error due to payload size, including diagnostic information about tree depth fallback and suggestions for reducing payload size.

```text
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.
```

--------------------------------

### Configure Claude Code MCP Server (Beta/Next)

Source: https://github.com/sammysnake-d/fast-context-mcp/blob/main/README.md

This JSON configuration is for setting up the beta or next release of Fast Context MCP with Claude Code. It's similar to the stable configuration but points to the `@next` version of the package.

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

--------------------------------

### Project Structure

Source: https://github.com/sammysnake-d/fast-context-mcp/blob/main/README.md

Outlines the directory structure of the fast-context-mcp project, detailing the purpose of key files and directories.

```text
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)
│   └── protobuf.mjs      # Protobuf encoder/decoder + Connect-RPC frames
├── README.md
└── LICENSE
```

--------------------------------

### Configure Claude Code MCP Server

Source: https://github.com/sammysnake-d/fast-context-mcp/blob/main/README.md

Add this configuration to your `~/.claude.json` file to set up Fast Context MCP as an MCP server for Claude Code. It specifies the command to run and environment variables, including the Windsurf API key.

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

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.