Ollama Web Search MCP Server

A stdio MCP server that exposes Ollama's hosted web search and web fetch APIs as tools any MCP client can call. Based on the Ollama web search docs.

Tools:

Prerequisites

• uv (provides uvx and uv tool install)
• An Ollama API key — create one at https://ollama.com/settings/keys (free account).

Install

For use as an MCP server in editors, install once so the binary is available immediately on startup (avoids timeout issues caused by uvx resolving packages on every invocation):

uv tool install ollama-web-search
# or from a local checkout:
# uv tool install .

For a quick smoke test without installing, you can use uvx (slower on first run because it resolves packages each time):

export OLLAMA_API_KEY=your_api_key_here
uvx ollama-web-search

It will sit waiting for MCP messages on stdio. Wire it into a client instead of running it by hand.

Client configuration

Set your key in the env block below. Use the installed binary (ollama-web-search) rather than uvx to avoid startup timeouts.

Claude Desktop / Claude Code (mcpServers block):

{
  "mcpServers": {
    "Ollama Web Search": {
      "command": "ollama-web-search",
      "args": [],
      "env": { "OLLAMA_API_KEY": "your_api_key_here" }
    }
  }
}

For Claude Code you can also add it from the CLI:

claude mcp add ollama-web-search \
  --env OLLAMA_API_KEY=your_api_key_here \
  -- ollama-web-search

Zed (~/.config/zed/settings.json, under context_servers):

{
  "context_servers": {
    "Ollama Web Search": {
      "command": "ollama-web-search",
      "args": [],
      "env": { "OLLAMA_API_KEY": "your_api_key_here" }
    }
  }
}

Cline:

{
  "mcpServers": {
    "Ollama Web Search": {
      "type": "stdio",
      "command": "ollama-web-search",
      "args": [],
      "env": { "OLLAMA_API_KEY": "your_api_key_here" }
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.ollama_web_search]
command = "ollama-web-search"
args = []
env = { OLLAMA_API_KEY = "your_api_key_here" }