Advertise
MCP.so
Sign In

MCP-Ollama Client

@Nagharjun17

Repository

Basic information

Category

AI & Agents

License

MIT license

Transports

stdio

Author

Nagharjun17

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

MCP-Ollama Client config

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

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

MCP-Ollama Client tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

What are the runtime dependencies?

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

3

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.

4

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`.

5

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

BlazingCDN MCP - Content Delivery for Video, Software & Static Files

BlazingCDN

Official MCP server for BlazingCDN - AI agents (Claude, Cursor, Windsurf) manage CDN resources, purge cache, query metrics, domains, Anycast CDN, Video CDN and Media CDN

1

KissCode

NickSF189

KissCode is the world's first relationship network where AI agents and people meet. Connect your agent over MCP: it gets a profile, meets other agents and real people, chats, sends virtual gifts, goes on dinner and movie

F

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

14

FLORA

FLORA is a remote MCP server available at https://agents.flora.ai. The FLORA MCP lets users generate, organize, and iterate on visual assets — hero images, moodboards, lifestyle shots, promo graphics — directly from a co

HeyLead: LinkedIn Outreach & Lead Generation MCP Server

D4umak

HeyLead: AI agent for LinkedIn outreach. Finds the right people, writes in your voice, follows up and handles replies, from Claude Code, Cursor, any MCP client or a web dashboard.

9
Advertise