Skip to main content
Glama
ollama-web-search-mcp

ollama-web-search-mcp

by wzul

Ollama Web Search MCP Server

An MCP server that exposes Ollama's web search API as a web_search tool for Claude Code.

Use it when the built-in Claude Code WebSearch returns no results for a site — the Ollama search backend indexes sites (like small personal blogs) that other backends miss.

Features

  • Single web_search tool: query (required) + count (optional, 1–10, default 5)

  • Reads your API key from the environment — never hardcoded, never committed

  • 10s outbound timeout, friendly errors for missing key / bad status / network failure

  • Pure Node.js stdio server — no build step, no runtime outside Node 18+

Related MCP server: CC Web MCP

Prerequisites

  • Node.js 18+ (tested on 20.x)

  • An Ollama account with an API key (Settings → API Keys)

Install

git clone https://github.com/wzul/ollama-web-search-mcp.git
cd ollama-web-search-mcp
npm install

Register with Claude Code

Register the server globally (available in every project) with one command:

claude mcp add --scope user ollama-web-search -- node "$HOME/ollama-web-search-mcp/index.js"

Why --scope user: claude mcp add defaults to the project-local scope. Without this flag the server is registered to the current project only and silently won't load when Claude Code is started from any other directory. If web_search doesn't appear after a restart, the registration is almost certainly project-scoped — fix it with claude mcp add --scope user ... (then cd <repo> && claude mcp remove ollama-web-search -s local to drop the stale entry).

Or add it manually to the top-level mcpServers object in ~/.claude.json:

{
  "mcpServers": {
    "ollama-web-search": {
      "command": "node",
      "args": ["/absolute/path/to/ollama-web-search-mcp/index.js"]
    }
  }
}

Set your API key

The server reads the key from the environment, so export it in your shell profile (~/.zshrc, ~/.bashrc, etc.):

export OLLAMA_API_KEY="your-ollama-api-key"

Security: use a key you have not shared anywhere. If a key was ever pasted into a chat, log, or screenshot, rotate it at ollama.com/settings/keys before using it here.

Then restart Claude Code — the web_search tool will be available in every session.

Claude Code ships a built-in WebSearch tool. If you want your sessions to use only the Ollama-backed web_search, deny the built-in one in ~/.claude/settings.json:

{
  "permissions": {
    "deny": ["WebSearch"]
  }
}

deny takes precedence over allow, and rules merge across scopes, so this stays blocked even if another settings file allows it. Restart Claude Code afterwards. You can verify with /permissions that WebSearch is no longer offered.

Usage

Ask Claude Code to search, e.g.:

web_search "wanzul.net"
web_search "best 5G plan malaysia" count 10

Results come back as a numbered list: title, URL, and content snippet.

Test

npm test

Runs 10 tests: unit tests for the fetch wrapper and result formatting (mocked fetch) plus a live stdio smoke test that drives the MCP protocol.

Helper skill (optional)

The repo ships a copy-paste install skill at .claude/skills/install-ollama-web-search/. Install it so you (or Claude Code) can reproduce these steps on demand:

mkdir -p ~/.claude/skills
cp -r .claude/skills/install-ollama-web-search ~/.claude/skills/

Once installed, an agent can follow it (or ask "install ollama-web-search") instead of retyping commands from memory.

Layout

  • index.js — MCP stdio server + searchOllama / formatResults exports

  • test.js — unit tests (mocked fetch) + stdio smoke test

  • package.json — deps (@modelcontextprotocol/sdk) and scripts

License

MIT

Available Tools

1 tool

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only a single tool, there is no possibility of confusing it with other tools. The purpose of web_search is clear and unambiguous.

    Naming Consistency5/5

    The tool name follows a consistent verb_noun pattern (web_search), which is predictable and readable even as the only tool in the server.

    Tool Count3/5

    The server has only one tool, which is on the thin side of the typical 3-15 range. For a dedicated search utility, one tool can be sufficient, but it feels minimal and lacks auxiliary features.

    Completeness5/5

    The tool fully covers the domain of web search by returning a numbered list of results with titles, URLs, and snippets. There are no obvious dead ends or missing critical operations for this simple purpose.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides web search and page fetching tools for third-party models (e.g., DeepSeek, Qwen, Kimi) in Claude Code, with configurable search backends, Markdown output, and safety boundaries.
      69 PyPI
      63
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A drop-in replacement for Claude's built-in web_search tool that automatically tracks usage and provides multiple search backends.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables performing web searches and fetching web page content via Ollama's hosted APIs, providing search results and raw page data.
      2
      186 PyPI
      1
      MIT