@bouroo/ollama-cloud-mcp
An MCP server that exposes capabilities as two tools — and — over stdio.
接入你的智能体
发布者自己的命令。不是 PlugMCP 端点。
用我们的密钥与日志托管一份副本。
npx -y @bouroo/[email protected]Claude Code 没有针对本地命令的安装链接。复制下方命令并在终端中运行。
claude mcp add bouroo-ollama-cloud-mcp -- npx -y @bouroo/ollama-cloud-mcp@0.1.1在终端中运行。
{ "mcpServers": { "bouroo-ollama-cloud-mcp": { "command": "npx", "args": [ "-y", "@bouroo/[email protected]" ] } }}claude_desktop_config.json
远程 URL 还是本机命令? 两种安装方式的区别
来自发布者
An MCP server that exposes capabilities as two tools — and — over stdio.
MCP server exposing Ollama's web_search and web_fetch capabilities over stdio.
web_searchweb_fetchweb_search for ranked results, web_fetch for a single page's content, over stdio.npx runs it with nothing to install. CI proves it by handshaking against the built file alone in an empty directory.https://ollama.com with an API key, or points OLLAMA_HOST at a signed-in local daemon and needs no key at all.lts/*, and no engines floor is declared, so no version is claimed that CI does not actually test.OLLAMA_HOST at a signed-in local daemon (see Configuration).There is no install step: npx fetches and runs the published package, which ships as a single self-contained bundle with no runtime dependencies.
npx -y @bouroo/ollama-cloud-mcp --help
Register the server with your MCP client.
Claude Code
claude mcp add ollama-cloud --env OLLAMA_API_KEY=your-key-here -- npx -y @bouroo/ollama-cloud-mcp
Claude Desktop / other clients — add this to claude_desktop_config.json or the equivalent mcpServers block:
{
"mcpServers": {
"ollama-cloud": {
"command": "npx",
"args": ["-y", "@bouroo/ollama-cloud-mcp"],
"env": { "OLLAMA_API_KEY": "your-key-here" }
}
}
}
Once registered, the client discovers both tools and can call them.
web_searchSearch the web and return ranked results. Use it for information beyond the model's training cutoff: news, releases, prices, current documentation.
Returns structuredContent.results — an array of { title, url, content } — plus a readable text rendering:
Web search results for "what is ollama?" (2):
[1] Ollama
URL: https://ollama.com/
Cloud models are now available in Ollama...
[2] What is Ollama? Introduction to the AI model management tool
URL: https://www.hostinger.com/tutorials/what-is-ollama
An introduction to running and managing local models...
web_fetchFetch a single page and return its content. Use it after web_search to read a promising result in full.
Returns structuredContent — { title, content, links } — plus a readable text rendering:
Fetched ollama.com
Title: Ollama
Cloud models are now available in Ollama...
Links (2):
- http://ollama.com/
- https://github.com/ollama/ollama
Pointing OLLAMA_HOST at a local, signed-in Ollama daemon is supported and needs no API key: the daemon handles its own authentication. If OLLAMA_API_KEY is set, it is always sent.
isError: true with a message naming the cause, so the model can explain it instead of the client losing the server.web_search reports No web results found for "<query>".web_fetch returns page content verbatim and does not truncate it.src/
index.ts composition root: CLI entry (stdio, --help, --version)
domain/ pure model — types, constants, pure rules
errors.ts OllamaWebError and the missing-key message
config.ts OllamaConfig, base-URL normalization and resolution
web.ts response types, URL and max-results normalization
interfaces/OllamaWebPort.ts the outbound contract the use cases depend on
usecases/ application logic
searchWeb.ts validate, clamp, call the port, parse the response
fetchPage.ts normalize the url, call the port, parse the response
parseResponses.ts shape raw payloads into the response types
adapters/ implementations that touch the outside world
OllamaWebClient.ts fetch transport: auth, timeout, status mapping
McpServer.ts tool registration, schemas, text formatting
test/
domain/config.test.ts config resolution and base-URL normalization
domain/web.test.ts target-URL and max-results normalization
usecases/webOperations.test.ts the use cases driven through a stub port
adapters/OllamaWebClient.test.ts transport, auth and error mapping
adapters/McpServer.test.ts in-memory MCP protocol tests
helpers.ts shared fakes
scripts/smoke.mjs end-to-end stdio smoke test
test/ mirrors the src/ layers. The OllamaWebPort seam keeps usecases/ independent of any concrete HTTP client — OllamaWebClient implements it, and the use-case tests exercise it with a stub.
Requires Bun for the toolchain; the published artifact runs on plain Node.
bun install
bun run typecheck # tsc --noEmit
bun run test # unit + in-memory MCP protocol tests
bun run build # bundles src/index.ts -> dist/index.js
bun run smoke # end-to-end stdio handshake against dist/
# With a key, exercise the live API as well:
OLLAMA_API_KEY=... node scripts/smoke.mjs "what is ollama?"
bun run smoke drives the built server over real stdio: it performs the MCP initialize handshake, lists tools, and calls web_search. Without OLLAMA_API_KEY it asserts the missing-key error path instead, which still proves the request wiring end to end.
.github/workflows/ci.yml runs on every push to main and every pull request, on the current Active LTS (lts/*):
node_modules to fall back on — this is what makes the "zero runtime dependencies" claim tested rather than assertedgit checkout -b feat/your-feature.git commit -m "feat: add …".git push origin feat/your-feature.Please add tests for any behaviour change and make sure bun run typecheck, bun run test and bun run smoke pass.
MIT © Kawin Viriyaprasopsook
MCP server exposing Ollama's web_search and web_fetch capabilities over stdio.
{ "mcpServers": { "bouroo-ollama-cloud-mcp": { "command": "npx", "args": [ "-y", "@bouroo/[email protected]" ] } }}工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
@bouroo/ollama Cloud 通过 stdio 在本地运行。
上次检查时间:2026-11-16。 MCP server exposing Ollama's web_search and web_fetch capabilities over stdio.