Skip to main content
Glama
deenesjakoruzh
VrtxOmega

Ollama-Omega

by VrtxOmega
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Status Version Stack License Tests

Ollama-Omega MCP server

A hardened MCP server that bridges the full Ollama ecosystem — local models and cloud-hosted behemoths alike — into any MCP-compatible IDE. No wrapper scripts. No bloated SDK. Just a single Python file with two dependencies.

DESIGN PRINCIPLE: Ollama-Omega does not abstract away Ollama. It exposes the complete Ollama API surface through 6 validated, error-handled MCP tools with zero information loss.

Architecture

┌─────────────────────────────────────────────────────┐
│                    MCP Client (IDE)                  │
│         Claude Desktop / Antigravity / etc.          │
└──────────────────────┬──────────────────────────────┘
                       │ stdio (JSON-RPC 2.0)
┌──────────────────────▼──────────────────────────────┐
│              ollama_mcp_server.py                     │
│  ┌──────────┐ ┌──────────┐ ┌───────────────────┐    │
│  │ Validator│ │ Dispatch │ │ Singleton httpx   │    │
│  │ + Schema │→│ Router   │→│ AsyncClient       │    │
│  └──────────┘ └──────────┘ │ (no redirects)    │    │
│                             └─────────┬─────────┘    │
└───────────────────────────────────────┼──────────────┘
                                        │ HTTP
┌───────────────────────────────────────▼──────────────┐
│                  Ollama Daemon                        │
│    Local models (GPU) │ Cloud models (API proxy)      │
└───────────────────────────────────────────────────────┘

Tools (6)

Tool

Purpose

ollama_health

Check connectivity and list currently running/loaded models

ollama_list_models

List all available models with size, loaded status, and modification date

ollama_chat

Send a chat completion request with message history and system prompt

ollama_generate

Generate a response for a given prompt without chat history

ollama_show_model

Show detailed information about a specific model (license, parameters)

ollama_pull_model

Download a model from the Ollama library

Hardening Audit

#

Category

Mitigation

1

SSRF

Redirects disabled on httpx client (follow_redirects=False)

2

Resource Leak

Singleton AsyncClient — one connection pool for server lifetime

3

Input Validation

_validate_required() gate on every tool before any HTTP call

4

JSON Safety

_safe_json() wrapper — never crashes on malformed responses

5

Structured Logging

All stderr output via logging module, not raw print()

6

DRY Payloads

_build_options() centralizes temperature/token mapping

7

Error Sanitization

_error() helper — no stack traces, no internals leaked to client

Quick Start

Requirements

  • Python 3.11+

  • pip install mcp httpx

Configure in Claude Desktop / Antigravity

{
  "mcpServers": {
    "ollama": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/ollama-mcp",
        "run",
        "python",
        "ollama_mcp_server.py"
      ],
      "env": {
        "PYTHONUTF8": "1",
        "OLLAMA_HOST": "http://localhost:11434",
        "OLLAMA_TIMEOUT": "300"
      }
    }
  }
}

Environment Variables

Variable

Default

Description

OLLAMA_HOST

http://localhost:11434

Ollama daemon URL

OLLAMA_TIMEOUT

300

Request timeout in seconds (long for large model pulls/cloud inference)

PYTHONUTF8

—

Set to 1 for Windows Unicode safety

Cloud Models

Ollama-Omega is version-agnostic. If your Ollama daemon exposes cloud-hosted models (e.g., qwen3.5:397b-cloud via API proxy), they are accessible through the same 6 tools — no configuration change required.

File Structure

Ollama-Omega/
  ollama_mcp_server.py     # MCP server (~307 lines) — hardened, single-file
  pyproject.toml            # Package metadata, CLI entry, PyPI classifiers
  requirements.txt          # mcp>=1.0.0, httpx>=0.27.0
  glama.json                # Glama MCP directory registration
  LICENSE                   # MIT
  CHANGELOG.md              # Version history
  tests/
    test_server.py           # 48 tests — tools, dispatch, errors, SSRF, config
  examples/
    basic_usage.py           # Programmatic MCP client example
  docs/
    BUILD_SPEC.md            # Internal build specification

Testing

pip install pytest
python -m pytest tests/ -v

48 tests covering:

  • Tool Definitions — schema validation, required fields, descriptions

  • Helper Functions — options builder, validation, JSON safety, error formatting

  • Dispatcher — all 6 tool paths with mocked HTTP responses

  • Error Handling — connection, timeout, HTTP status, exception sanitization

  • Configuration — environment defaults, SSRF mitigation, server identity

Companion Server

Ollama-Omega is the transport layer for the Omega Brain MCP — cross-session episodic memory + 10-gate VERITAS Build pipeline. Together they form the sovereign intelligence stack.

License

MIT

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - A tier

How are these scores calculated?

Resources

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/VrtxOmega/Ollama-Omega'

If you have feedback or need assistance with the MCP directory API, please join our Discord server