# jonigl/mcp-client-for-ollama architecture

> Architecture diagram of the GitHub repository jonigl/mcp-client-for-ollama, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jonigl/mcp-client-for-ollama
- Repository: https://github.com/jonigl/mcp-client-for-ollama

## Overview

##### Project Type and Purpose
- This is an open-source Python CLI tool (monolithic, modular design) that mediates between:
- The end user (terminal)
- Local Ollama LLM runtime (via HTTP API)
- One or more external MCP-compliant tool servers (via STDIO, SSE, or HTTP)

1. User → CLI: command/input
2. CLI → Core Client: parsed parameters
3. Core Client → Config Manager & Model Manager: load settings & available models
4. Core Client → Ollama: send user query + tool definitions
5. Ollama → Core Client: streaming response chunks or tool-call request
6. Core Client → Tool Manager: on function call in response
7. Tool Manager → Server Discovery / Connector: invoke MCP server call
8. MCP Server → Tool Manager: return tool output
9. Tool Manager → Core Client → Ollama: send tool output back to model
10. Ollama → Core Client → CLI: final response display
11. Config Manager → File System: save/load user configurations

##### Architectural Patterns & Principles
- Layered modular design (UI → orchestration → domain modules → external interfaces)
- Dependency injection of transports (connector abstraction)
- Single-responsibility modules (config, models, tools, streaming)
- Streaming I/O for real-time feedback

##### Technologies & Frameworks
- Python 3.10+
- Rich (for terminal UI)
- uv / uvx (optional for invocation)
- HTTP & SSE protocols
- Process STDIO for external tools

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External User Input
    User["End User (Terminal)"]:::external
    User -->|"command/input"| CLI

    %% CLI Layer
    subgraph "CLI / Entry Point"
        direction TB
        CliPY["cli-package/ollmcp/cli.py"]:::internal
        MainPY["mcp_client_for_ollama/__main__.py"]:::internal
    end
    CLI[CLI Layer]:::internal
    CLI --> CliPY
    CLI --> MainPY
    CliPY -->|parsed parameters| CoreClient
    MainPY -->|parsed parameters| CoreClient

    %% Core Client Orchestrator
    subgraph "Core Client Orchestrator"
        direction TB
        CoreClient["mcp_client_for_ollama/client.py"]:::internal
    end

    %% Configuration Management
    subgraph "Configuration Management"
        direction TB
        ConfigManager["mcp_client_for_ollama/config/manager.py"]:::internal
        Defaults["mcp_client_for_ollama/config/defaults.py"]:::internal
        ConfigManager --> Defaults
    end
    CoreClient -->|"load settings"| ConfigManager

    %% Model Management
    subgraph "Model Management"
        direction TB
        ModelManager["mcp_client_for_ollama/models/manager.py"]:::internal
    end
    CoreClient -->|"fetch models"| ModelManager

    %% Server Discovery & Connectors
    subgraph "Server Discovery & Connectors"
        direction TB
        Discovery["mcp_client_for_ollama/server/discovery.py"]:::internal
        Connector["mcp_client_for_ollama/server/connector.py"]:::internal
    end

    %% Tool Management
    subgraph "Tool Management"
        direction TB
        ToolManager["mcp_client_for_ollama/tools/manager.py"]:::internal
    end
    CoreClient -->|"on function call"| ToolManager
    ToolManager --> Discovery
    ToolManager --> Connector

    %% Utilities
    subgraph "Utilities"
        direction TB
        Streaming["mcp_client_for_ollama/utils/streaming.py"]:::internal
        Constants["mcp_client_for_ollama/utils/constants.py"]:::internal
        Version["mcp_client_for_ollama/utils/version.py"]:::internal
    end

    %% External Systems
    subgraph "External Systems"
        direction TB
        Ollama["Ollama Local Runtime\n(HTTP)"]:::external
        MCPServer["MCP Server\n(STDIO/SSE/HTTP)"]:::external
        FileSystem["User File System\n(JSON config)"]:::database
    end

    %% Data Flows
    CoreClient -->|"send query + tools"| Ollama
    Ollama -->|"streaming response/tool call"| CoreClient
    ToolManager -->|"invoke tool"| MCPServer
    MCPServer -->|"tool output"| ToolManager
    ToolManager -->|"send tool output"| CoreClient
    CoreClient -->|"final response"| CLI
    ConfigManager -->|"load/save configs"| FileSystem

    %% Testing & CI (Footnote)
    subgraph "Testing & CI"
        direction TB
        Tests1["cli-package/tests/"]:::internal
        Tests2["tests/"]:::internal
        CI1[".github/workflows/ci.yml"]:::internal
        CI2[".github/workflows/publish.yml"]:::internal
    end

    %% Click Events
    click CliPY "https://github.com/jonigl/mcp-client-for-ollama/blob/main/cli-package/ollmcp/cli.py"
    click MainPY "https://github.com/jonigl/mcp-client-for-ollama/blob/main/mcp_client_for_ollama/__main__.py"
    click CoreClient "https://github.com/jonigl/mcp-client-for-ollama/blob/main/mcp_client_for_ollama/client.py"
    click ConfigManager "https://github.com/jonigl/mcp-client-for-ollama/blob/main/mcp_client_for_ollama/config/manager.py"
    click Defaults "https://github.com/jonigl/mcp-client-for-ollama/blob/main/mcp_client_for_ollama/config/defaults.py"
    click ModelManager "https://github.com/jonigl/mcp-client-for-ollama/blob/main/mcp_client_for_ollama/models/manager.py"
    click Discovery "https://github.com/jonigl/mcp-client-for-ollama/blob/main/mcp_client_for_ollama/server/discovery.py"
    click Connector "https://github.com/jonigl/mcp-client-for-ollama/blob/main/mcp_client_for_ollama/server/connector.py"
    click ToolManager "https://github.com/jonigl/mcp-client-for-ollama/blob/main/mcp_client_for_ollama/tools/manager.py"
    click Streaming "https://github.com/jonigl/mcp-client-for-ollama/blob/main/mcp_client_for_ollama/utils/streaming.py"
    click Constants "https://github.com/jonigl/mcp-client-for-ollama/blob/main/mcp_client_for_ollama/utils/constants.py"
    click Version "https://github.com/jonigl/mcp-client-for-ollama/blob/main/mcp_client_for_ollama/utils/version.py"
    click Tests1 "https://github.com/jonigl/mcp-client-for-ollama/tree/main/cli-package/tests/"
    click Tests2 "https://github.com/jonigl/mcp-client-for-ollama/tree/main/tests/"
    click CI1 "https://github.com/jonigl/mcp-client-for-ollama/blob/main/.github/workflows/ci.yml"
    click CI2 "https://github.com/jonigl/mcp-client-for-ollama/blob/main/.github/workflows/publish.yml"

    %% Styles
    classDef internal fill:#B3D1FF,stroke:#333,stroke-width:1px;
    classDef external fill:#CFFFCF,stroke:#333,stroke-width:1px;
    classDef database fill:#FFF7B3,stroke:#333,stroke-width:1px;
```
