MCP-Ollama Client

Name: MCP-Ollama Client
Author: Nagharjun17

@Nagharjun17

Repository

About MCP-Ollama Client

Lightweight MCP client that uses a local Ollama LLM to query multiple MCP servers defined in config.json

#python #ai-agents #chat-interface #llms #local-llm #function-calling #ollama #mcp-client

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "MCP-Ollama-Client": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP-Ollama Client?

MCP-Ollama Client is a command‑line chat client that runs entirely offline with a local LLM via Ollama and connects to any number of Model Context Protocol (MCP) servers declared in a single config.json. It is designed for developers who want to use local function‑calling models together with MCP tools.

How to use MCP-Ollama Client?

Clone the repository, set up a Python ≥ 3.12 virtual environment with uv, install dependencies, pull a local model with ollama pull qwen3:14b, edit the model name and server settings in config.json, then run uv run client.py. At startup the client launches every MCP server, aggregates their tool schemas with server‑name prefixes (e.g. postgres.*, filesystem.*), and presents the merged list to the LLM.

Key features of MCP-Ollama Client

Runs entirely offline with a local LLM via Ollama
Connects to multiple MCP servers side‑by‑side
Collision‑free tool names via server‑name prefixing
Everything configured in one config.json file
No cloud API keys required

Use cases of MCP-Ollama Client

Query a local database with natural language using MCP tools
Read or write files on a remote share through a filesystem MCP server
Combine data from multiple MCP sources in a single conversation
Test and debug MCP server integrations without a cloud LLM

FAQ from MCP-Ollama Client

What is the default model and does it require cloud access?

The default model is qwen3:14b. Any function‑calling model that Ollama exposes will work. No cloud keys are required; everything runs locally.

What are the runtime dependencies?

Python ≥ 3.12, Ollama ≥ 0.8.0, and any MCP servers that support stdio transport.

How does tool naming work when multiple servers are used?

Tools are exposed as <server>.<tool> (for example postgres.list_schemas, filesystem.read_file) so names never clash, even when different servers provide tools with the same name.

Where is data stored and can I add or remove servers without changing code?

Data stays entirely local. Servers are defined in config.json under the mcpServers key; you can add or remove servers by editing that file without touching client.py.

What transport does the client use to communicate with MCP servers?

Each MCP server is started as its own stdio subprocess. No network transport is used between the client and the servers.

Comments

More AI & Agents MCP servers

Unreal Engine Generative AI Support Plugin

prajwalshettydev

Unreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti

622

Model Context Protocol for Unreal Engine

chongdashu

Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

2.0K