Ollama Cloud Web Search Nodejs

by mrfl-orchestra

Not rated
GitHub

About

A Node.js MCP server exposing Ollama's web search and web fetch APIs as MCP tools. TypeScript, stdio transport, npm-publishable.

Details

Author
mrfl-orchestra
Categories
Search, Other, AI, Knowledge Base

Setup

Install Ollama Cloud Web Search Nodejs in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/mrfl-orchestra/ollama-web-search-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

A Node.js MCP server exposing Ollama's web search and web fetch APIs as MCP tools. TypeScript, stdio transport, npm-publishable.

ollama-web-search-mcp (Node.js / TypeScript)

A Node.js / TypeScript MCP (Model Context Protocol) serverthat exposesOllama's web search and web fetch APIsas MCP tools.

This is theJavaScript / Node.js equivalentof Ollama'sofficial Python MCP server. While Ollama provides a Python MCP server for web search, there was no Node.js version available — this project fills that gap. It's written in TypeScript, runs on Node.js 18+, and is published to npm for easynpxusage.

Ollama's official MCP server for web search is written in Python and requiresuvor a Python runtime. Many MCP clients and agent frameworks (Claude Desktop, Cursor, Cline, Codex, etc.) can spawn any process, but if your stack is already Node.js-based, you probably don't want to install Python just for one MCP server. This package runs purely on Node.js — no Python needed.

- web_search— Performs a web search via Ollama's hosted API and returns results (title, URL, content snippet)
- web_fetch— Fetches a single web page by URL and returns its title, content, and links
- Written inTypeScript, compiled to ESM JavaScript
- Stdio transport(standard for MCP servers)
- Zero runtime dependencies beyond the MCP SDK
- Published tonpmas@mrfl/ollama-web-search-mcpwith a CLI binary
- Usable as alibrary— importwebSearch()andwebFetch()directly in your Node.js code

- Node.js 18 or higher
- An
Ollama API key(free Ollama account required)

npm install -g @mrfl/ollama-web-search-mcp

Or use directly with npx (no install needed):

git clone https://github.com/MRFL-Orchestra/ollama-web-search-mcp.git cd ollama-web-search-mcp npm install npm run build

Set your Ollama API key as an environment variable:

export OLLAMA_API_KEY="your_api_key_here"

Add the server to your MCP client configuration:

{ "mcpServers": { "ollama-web-search": { "command": "npx", "args": ["@mrfl/ollama-web-search-mcp"], "env": { "OLLAMA_API_KEY": "your_api_key_here" } } } }
{ "mcpServers": { "ollama-web-search": { "type": "stdio", "command": "npx", "args": ["@mrfl/ollama-web-search-mcp"], "env": { "OLLAMA_API_KEY": "your_api_key_here" } } } }
[mcp_servers.ollama-web-search] command = "npx" args = ["@mrfl/ollama-web-search-mcp"] env = { "OLLAMA_API_KEY" = "your_api_key_here" }
{ "mcpServers": { "ollama-web-search": { "command": "node", "args": ["/path/to/ollama-web-search-mcp/dist/index.js"], "env": { "OLLAMA_API_KEY": "your_api_key_here" } } } }

Performs a web search using Ollama's hosted search API.

- query(string, required) — The search query string
- max_results(integer, optional, default 5, max 10) — Maximum results to return

Returns:Array of search results, each containing:

- title— Title of the web page
- url— URL of the web page
- content— Relevant content snippet

Fetches the content of a single web page by URL.

- url(string, required) — The absolute URL to fetch

- title— Title of the web page
- content— Main content of the web page
- links— Array of links found on the page

You can also use the client functions directly in your own Node.js / TypeScript code:

import { webSearch, webFetch } from "@mrfl/ollama-web-search-mcp"; // Web search const results = await webSearch("what is ollama?", 5); console.log(results.results[0].title); // Web fetch const page = await webFetch("https://ollama.com"); console.log(page.title); console.log(page.links);

Both functions accept an optionalapiKeyparameter (defaults toOLLAMA_API_KEYenvironment variable).

npm install # Install dependencies npm run build # Compile TypeScript npm run dev # Watch mode npm run typecheck # Type-check without emitting

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Structural AI Search Readiness MCP. Audit, dry-run fixes, rescore, doctor. No LLM rankings.

Enhances LLM responses with factual, real-time web content using Jina AI's grounding capabilities.

Efficient web search optimized for LLM-friendly content using the Jina AI API.

A server to query Wikipedia and automatically fact-check information for any LLM with a compatible MCP client.

A comprehensive, production-ready research server (MCP). Provide your LLM clients with real-time access to the web, data, and more.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Search campgrounds around the world on campertunity, check availability, and provide booking links.

The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.

All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.

MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.