mcp-client-for-ollama
Harness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, mo
What is mcp-client-for-ollama?
Harness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved preferences.
Overview of mcp-client-for-ollama
What it is
MCP Client for Ollama (ollmcp) is a modern, interactive terminal application (TUI) built for harness engineering, connecting local Ollama LLMs to one or more Model Context Protocol (MCP) servers. It fully supports the core MCP primitives: tools, prompts, and resources. The client provides a controlled terminal space where the user steers and the agent executes. With a rich, user-friendly interface, it allows safe real-time management of the setup without coding. It is designed for building, testing, or exploring MCP servers with local LLMs.
Key features
- Agent Mode: Iterative tool execution when models request multiple tool calls, with a configurable loop limit and interactive choices (continue, wrap up, or abort).
- Multi-Server Support: Connect to multiple MCP servers simultaneously.
- MCP Prompts Support: Browse, invoke, and manage prompts from MCP servers with argument collection, preview, and safe rollback.
- MCP Resources Support: Browse and read contextual data from MCP servers including files, documents, and structured data.
- Streaming Responses: View model outputs in real-time as they are generated.
- Human-in-the-Loop (HIL): Review and approve tool executions before they run for enhanced control and safety.
- Dynamic Model Switching: Switch between any installed Ollama model without restarting the client.
Use cases
The client is used for harness engineering, connecting local Ollama LLMs to MCP servers for advanced tool execution. It supports building, testing, and exploring MCP servers with local LLMs. Use cases include interacting with MCP tools, prompts, and resources in a controlled terminal environment, with features like agent mode and human-in-the-loop for safety.
Getting started
bash # Install ollmcp via uv uv tool install --upgrade ollmcp # or via pip pip install --upgrade ollmcp # Add an MCP server (example: playwright stdio server) ollmcp mcp add playwright -- npx @playwright/mcp@latest # Run the client ollmcp
License and pricing
License: MIT. Open source.
Based on the project's public README and repository metadata.