MCP.so
Sign In

Ollama MCP Server

@NewAITees

Basic information

Category

AI & Agents

Transports

stdio

Author

NewAITees

About Ollama MCP Server

No overview available yet

Ollama MCP Server config

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

{
  "mcpServers": {
    "ollama-MCP-server": {
      "command": "python",
      "args": [
        "-m",
        "unittest",
        "discover"
      ]
    }
  }
}

Ollama MCP Server 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 ollama-MCP-server?

ollama-MCP-server is a Model Context Protocol (MCP) server that communicates with a local Ollama LLM instance, providing task decomposition, result evaluation, model management, and workflow management for MCP-compatible applications.

How to use ollama-MCP-server?

Install the package with pip install ollama-mcp-server, then configure the server in your MCP client (e.g., Claude Desktop) using the claude_desktop_config.json file. Tools such as add-task, decompose-task, evaluate-result, and run-model are invoked via the MCP protocol.

Key features of ollama-MCP-server

  • Complex task decomposition into manageable subtasks
  • Evaluation and validation of results against criteria
  • Management and execution of Ollama models
  • Standardized MCP protocol communication
  • Enhanced error handling with structured messages
  • Performance optimization (connection pooling, LRU cache)

Use cases of ollama-MCP-server

  • Break down a large problem into smaller, prioritized subtasks
  • Analyze and score a result based on accuracy, completeness, and clarity
  • Run an Ollama model directly with custom parameters (model, prompt, temperature)
  • Automate multi-step LLM workflows with error recovery

Frequently asked questions

1

What runtime and dependencies are required?

The server requires Python, the `ollama-mcp-server` package, and a local installation of Ollama with at least one model pulled (e.g., `llama3`). Environment variables like `OLLAMA_HOST`, `DEFAULT_MODEL`, and `LOG_LEVEL` can be set.

2

How is the Ollama model selected?

Model selection follows a priority order: (1) the `model` parameter in a tool call, (2) the `env` section of the MCP configuration file, (3) the `OLLAMA_DEFAULT_MODEL` environment variable, and (4) the default value (`llama3`).

3

What performance optimizations are included?

The server uses connection pooling (max 10 concurrent connections per host) and an LRU cache (max 100 entries) to reduce response times and lower Ollama server load. These settings are adjustable in `config.py`.

4

How are errors reported?

Errors return a structured JSON response with a `message`, `status_code`, and optional `details` (e.g., the provided ID for a missing task). If a model is not found, the error message includes the list of available models.

5

What transports and authentication are supported?

The server communicates over stdio using the MCP protocol. The README does not mention authentication mechanisms; access depends on local Ollama and MCP client configuration.

Comments

More AI & Agents MCP servers