🦙 Ollama MCP Server (Python)

Supercharge your AI assistant with local LLM access, run powerful AI models right on your own computer, no internet required.

A Python MCP server that exposes your local Ollama models as tools for AI assistants like Windsurf, VS Code, Claude Desktop, and more.

📚 Full Documentation

What It Does

Connect your local LLMs to any MCP-compatible AI assistant. No cloud APIs needed.

Quick Start

Prerequisites: Python 3.10+, Ollama running locally

pip install mcp-ollama-python

Windsurf / VS Code

Add to your MCP config (mcp_config.json):

{
  "mcpServers": {
    "ollama": {
      "command": "py",
      "args": ["-m", "mcp_ollama_python"],
      "disabled": false
    }
  }
}

Restart your editor — done. Your AI assistant can now use local Ollama models.

Try It

Type in your AI assistant's chat:

MCP Tool: ollama / ollama_chat — Use model llama3.1 and explain quantum computing

Key Features

• 🔧 8 MCP tools — Full Ollama SDK access

• 🔄 Hot-swap architecture — Drop a file in tools/, it's auto-discovered

• 🎯 Type-safe — Pydantic models throughout

• 🚀 Lightweight — Minimal dependencies, fast startup

• 🔌 Universal — Works with any MCP client

Documentation

License

MIT

Made with ❤️ using Python, Poetry, and Ollama