ollama-web-search 0.1.0

MCP stdio server exposing Ollama's hosted web search and web fetch APIs as tools for any MCP client.

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:

Tool	Args	Returns
web_search	query (string), max_results (int, default 5, max 10)	{ results: [{ title, url, content }] }
web_fetch	url (string)	{ title, content, links: [...] }

Prerequisites

• uv (provides uvx, handles Python + dependencies)
• An Ollama API key — create one at https://ollama.com/settings/keys (free account).

The published package runs with uvx ollama-web-search, which downloads and runs it in an isolated environment; no clone or pip install step is needed.

Run it directly (smoke test)

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.

To run from a local checkout instead: uv run ollama-web-search.

Client configuration

Set your key in the env block below.

Claude Desktop / Claude Code (mcpServers block):

{
  "mcpServers": {
    "Ollama Web Search": {
      "command": "uvx",
      "args": ["ollama-web-search"],
      "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 \
  -- uvx ollama-web-search

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

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

Cline:

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

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

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