mcpField
L
Local MCP Client

Local MCP Client

Local
github.com/mytechnotalentAI & Agents5Updated 48w ago
Repository

About Local MCP Client

Local MCP Client is a web and API interface for using natural language with configurable MCP servers through Ollama and a local LLM. It supports structured tool execution and dynamic agent behavior.

Key features

  1. 01Interact through natural language
  2. 02Connect to configurable MCP servers
  3. 03Use Ollama and local LLMs
  4. 04Provide web and API interfaces

Use cases

  1. 01Call MCP tools through a local LLM
  2. 02Run structured tool actions on MCP servers

MCP support

The client connects to configurable MCP servers, allowing a local LLM to initiate structured tool calls through natural-language interaction.

#local#mcp#ollama#ollama-client#model-context-protocol#mcp-client

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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.


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

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

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

brew install ollama
ollama serve
ollama pull llama3:8b

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

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
ollama serve
ollama pull llama3:8b

Step 3a: Clone MCP Servers - MAC/Linux

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

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

ollama serve

Step 5a: Run MCP Client - MAC/Linux

export BNJLAT = "<your-binja-api-token>"
uv run local_mcp_client.py

Step 5b: Run MCP Client - Windows

$env:BNJLAT = "<your-binja-api-token>"
uv run local_mcp_client.py

Step 6: Run Tests

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.