Skip to content
MCP server

Localize

Offload log reading, web research and test-gated coding to your local LLM

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.1.6
Listing updated
today

Similar MCP servers

About Localize

Localize is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

Localize targets a cost problem: reading a 5,000-line test log or a few docs pages burns the same frontier-model tokens as hard design work. It hands that bulk work to a model on your own machine and returns only the answer. In the README's example a 50 KB test log (about 19,100 tokens read locally) came back to Claude as roughly 130 tokens.

There are three working tools plus configuration. offload runs a noisy command or reads a large file and answers a question about it. research searches the web via a SearXNG URL, reads the pages in full and returns a cited answer that Claude never sees as pages. delegate is opt-in: the local model writes one file in an isolated git worktree and retries against a test Claude wrote first, feeding back parsed failures while keeping the test source hidden, and Claude gets a one-line verdict. A configure call shows and changes settings without restarting.

It works with Ollama, llama.cpp, LM Studio, vLLM, LocalAI or any OpenAI-compatible endpoint, with no dependencies beyond Node 18 and git. The author's benchmark of 120 delegate runs rates qwen3-coder 30B as the best default among the three models tried.

Install

Run in a terminal

claude mcp add localize -- npx -y localize-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": [
        "-y",
        "localize-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": [
        "-y",
        "localize-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "localize": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "localize-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": [
        "-y",
        "localize-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": [
        "-y",
        "localize-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • LLW_BASE_URLModel server URL (Ollama, llama.cpp, LM Studio, vLLM). Default http://localhost:11434
  • LLW_MODELModel to use; optional if the server has only one
  • LLW_SEARCH_URLSearXNG URL for web research (optional)

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

offload
Run a command or read a large file with the local model and return the answer.
research
Search the web and return a cited answer from the full pages.
delegate
Have the local model write one file until a given test passes.
configure
Show or change configuration, backend and models.

What it does

Offload noisy commands
A local model reads logs and files and returns the answer.
Cited web research
Searches and reads pages in full via SearXNG, returning a cited summary.
Test-gated delegation
Writes one file in a git worktree until your test passes.
Parallel calls
Several offloads or delegates run at once.
Any local backend
Ollama, llama.cpp, LM Studio, vLLM and OpenAI-compatible servers.
Runtime configuration
One configure call inspects and changes settings.

Good for

  • Find the one failing test in a huge log
  • Answer questions from long documentation pages without filling context
  • Delegate small well-specified helpers with a test written first
  • Cut frontier-model token spend on routine reading

Pricing

Open source

Open-source; runs on your own hardware

Localize FAQ

Which models work?

Any model served by Ollama, llama.cpp, LM Studio, vLLM, LocalAI or an OpenAI-compatible endpoint; CPU-only works but is slower.

Is delegate on by default?

No, offload and research are the defaults and delegate is opt-in.

What does it need to install?

Node 18 or newer, git and a running local model server.

How does delegate avoid overwriting my work?

It works in an isolated worktree and does not apply the file if it changed meanwhile.

Is Localize free?

Yes. Localize is open source, so you can use and self-host it for free.

How do I add Localize to Claude Code?

Run this command in your terminal: claude mcp add localize -- npx -y localize-mcp

What are the best alternatives to Localize?

The closest alternatives to Localize are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers