Fff.Nvim MCP Server

<i>A file search toolkit for humans and AI agents. Really fast.</i>

Local serverstdioTypeScript

What is the Fff.Nvim MCP server?

A file search toolkit for humans and AI agents. Really fast.. The fff.nvim mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 7 defined tools rather than through you.

Its toolset

Everything the assistant can do here goes through one of these:

  • Modes — Three operating modes, switchable at runtime with /fff-mode:
  • Commands — The Pi extension swaps pi's native tools for FFF implementations and feeds the interactive editor's @-mention autocomplete from the frecency-ranked
  • Installation — The Installation tool exposed by this server
  • Configuration — flex = { size = 130, wrap = 'top' }, min_list_height = 10, -- do not display anything except the list below this threshold show_scrollbar = true
  • Constraints — Mix freely: git:modified src//*.rs !src//mod.rs user controller
  • Troubleshooting — The best file search picker for neovim. Period. Faster and more intuitive queries, frecency ranking, definition classification and much more
  • Build — The Build tool exposed by this server

Adding it to your client

@ff-labs/fff-node on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

When to reach for it

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Fff.Nvim's toolset — Modes, Commands, Installation and 4 more — is a fair guide to whether it matches your workflow. It is maintained by dmtrkovalenko; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the fff.nvim mcp server does with a few real requests.

Available tools

ToolWhat it does
ModesThree operating modes, switchable at runtime with /fff-mode:
CommandsThe Pi extension swaps pi's native tools for FFF implementations and feeds the interactive editor's @-mention autocomplete from the frecency-ranked index.
InstallationThe Installation tool exposed by this server.
Configurationflex = { size = 130, wrap = 'top' }, min_list_height = 10, -- do not display anything except the list below this threshold show_scrollbar = true, path_shorten_strategy = 'middle_number', -- 'middle_number' | 'middle' | '
ConstraintsMix freely: git:modified src/**/*.rs !src/**/mod.rs user controller.
TroubleshootingThe best file search picker for neovim. Period. Faster and more intuitive queries, frecency ranking, definition classification and much more.
BuildThe Build tool exposed by this server.

How to install the Fff.Nvim MCP server

{
  "mcpServers": {
    "fff-nvim": {
      "command": "npx",
      "args": ["-y", "@ff-labs/fff-node"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • Use Fff.Nvim to Modes.
  • Use Fff.Nvim to Commands.
  • Use Fff.Nvim to Installation.

Frequently asked questions

It connects Fff.Nvim to MCP-compatible AI assistants such as Claude and Cursor, exposing 7 tools (Modes, Commands, Installation, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Fff.Nvim directly.