local_mcp_client

Local MCP Client is a cross-platform web and API interface for interacting with configurable MCP servers using natural language, powered by Ollama and any local LLM of choice, enabling structured tool execution and dynamic agent behavior.

5 stars PythonAI & Machine Learning Updated Aug 3, 2025

locallocalizedmcpmcp-clientmodel-context-protocolollamaollama-client

Documentation

Local MCP Client

Step 1a: Create Virtual Env & Install Requirements - MAC/Linux

bash

curl -LsSf https://astral.sh/uv/install.sh | sh
cd Local_MCP_Client
uv init .
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

Step 1b: Create Virtual Env & Install Requirements - Windows

bash

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
cd Local_MCP_Client
uv init .
uv venv
.venv\Scripts\activate
uv pip install -r requirements.txt

Step 2a: Install Ollama & Pull LLM Model - MAC

bash

brew install ollama
ollama serve
ollama pull llama3:8b

Step 2b: Install Ollama & Pull LLM Model - Linux

bash

curl -fsSL https://ollama.com/install.sh | sh
ollama serve
ollama pull llama3:8b

Step 2c: Install Ollama & Pull LLM Model - Windows

Download Ollama HERE

bash

ollama serve
ollama pull llama3:8b

Step 3a: Clone MCP Servers - MAC/Linux

bash

cd ~/Documents
git clone https://github.com/mytechnotalent/MalwareBazaar_MCP.git
git clone https://github.com/Invoke-RE/binja-lattice-mcp

Step 3b: Clone MCP Servers - Windows

bash

cd "$HOME\Documents"
git clone https://github.com/mytechnotalent/MalwareBazaar_MCP.git
git clone https://github.com/Invoke-RE/binja-lattice-mcp

Step 4: Run Ollama

bash

ollama serve

Step 5a: Run MCP Client - MAC/Linux

bash

export BNJLAT = ""
uv run local_mcp_client.py

Step 5b: Run MCP Client - Windows

bash

$env:BNJLAT = ""
uv run local_mcp_client.py

Step 6: Run Tests

code

python -m unittest discover -s tests

uv pip install coverage==7.8.0
coverage run --branch -m unittest discover -s tests
coverage report -m
coverage html
open htmlcov/index.html  # MAC
xdg-open htmlcov/index.html  # Linux
start htmlcov\index.html  # Windows
coverage erase

License

Apache License, Version 2.0

Frequently asked questions

What is local_mcp_client?

local_mcp_client is Local MCP Client is a cross-platform web and API interface for interacting with configurable MCP servers using natural language, powered by Ollama and any local LLM of choice, enabling structured tool execution and dynamic agent behavior.

How do I install local_mcp_client?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is local_mcp_client open source?

Yes — it is hosted on GitHub at https://github.com/mytechnotalent/Local_MCP_Client and has 5 stars.

Related MCP tools

mcp-client-for-ollama

A text-based user interface (TUI) client for interacting with MCP servers using Ollama. Features include multi-server, dynamic model switching, streaming res...

351 Python

aicommand-line-toolgenerative-ai+17

minima

On-premises conversational RAG with configurable containers for the Model Context Protocol. Enhance AI assistants with powerful integrations.

1,019 Python

aiclaudecustom-gpts+9

fastmcp

🚀 The fast, Pythonic way to build MCP servers and clients Trusted by 19900+ developers. Trusted by 19900+ developers. Trusted by 19900+ developers.

19,927 Python

agentsfastmcpllms+6

upsonic

Agent Framework For Fintech for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.

7,670 Python

agentagent-frameworkclaude+7

mcp-agent

Build effective agents using Model Context Protocol and simple workflow patterns Python-based implementation. Trusted by 7600+ developers.

7,669 Python

agentsaiai-agents+5

mcp-bridge

A middleware to provide an openAI compatible endpoint that can call MCP tools Python-based implementation. Trusted by 800+ developers.

869 Python

aiclaudemcp+5

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP