Ollama MCP Server

An MCP (Model Context Protocol) server that provides tools to interact with Ollama models running on your local machine.

Features

• List Models: Get all available Ollama models
• Chat: Interactive chat with conversation history
• Generate: Single prompt generation
• Pull Models: Download new models from Ollama registry
• Delete Models: Remove models from local installation

Prerequisites

• Ollama installed and running locally
• Node.js 18+ and npm

Installation

1. Clone or download this repository
2. Install dependencies:

npm install

1. Build the project:

npm run build

Usage

Development Mode

npm run dev

Production Mode

npm run build
npm start

Using with Claude Desktop

Add this server to your Claude Desktop configuration:

{
  "mcpServers": {
    "ollama": {
      "command": "node",
      "args": ["/path/to/ollama-mcp/dist/index.js"]
    }
  }
}

Using with Cursor

If you're using Cursor, add the server to your MCP configuration file at ~/.cursor/mcp/config.json:

{
  "mcpServers": {
    "ollama": {
      "command": "node",
      "args": ["/path/to/ollama-mcp/dist/index.js"]
    }
  }
}

Alternatively, you can copy the ready-made config shipped with this repo:

mkdir -p ~/.cursor/mcp
cp /path/to/ollama-mcp/mcp.config.json ~/.cursor/mcp/config.json

Available Tools

ollama_list_models

Lists all available Ollama models on your system.

ollama_chat

Chat with a model using conversation history.

• model: Name of the Ollama model
• messages: Array of message objects with role ('system', 'user', 'assistant') and content

ollama_generate

Generate a response from a single prompt.

• model: Name of the Ollama model
• prompt: The input prompt

ollama_pull_model

Download a model from the Ollama registry.

• model: Name of the model to download

ollama_delete_model

Remove a model from your local installation.

• model: Name of the model to delete

Configuration

Set the OLLAMA_BASE_URL environment variable to change the Ollama server URL (default: http://localhost:11434).

License

MIT