mcp-ollama-python 1.0.2__tar.gz → 1.0.4__tar.gz

mcp_ollama_python-1.0.4/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: mcp-ollama-python
+Version: 1.0.4
+Summary: Model Context Protocol server that proxies local Ollama to MCP clients like Windsurf and VS Code
+License: MIT
+License-File: LICENSE
+Author: Pedja Blagojevic
+Author-email: pb@internetics.net
+Requires-Python: >=3.10,<3.15
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: httpx (>=0.27.0,<0.28.0)
+Requires-Dist: mcp (>=1.0.0,<2.0.0)
+Requires-Dist: psutil (>=7.1.3,<8.0.0)
+Requires-Dist: pydantic (>=2.7.0,<3.0.0)
+Requires-Dist: rich (>=13.7.0,<14.0.0)
+Requires-Dist: tzdata (>=2024.1,<2025.0)
+Project-URL: Homepage, https://github.com/pblagoje/mcp-ollama-python
+Description-Content-Type: text/markdown
+
+# 🦙 Ollama MCP Server (Python)
+
+**Supercharge your AI assistant with local LLM access**
+
+[![Python](https://img.shields.io/badge/Python-3.10+-blue)](https://python.org)
+[![Poetry](https://img.shields.io/badge/Poetry-1.0+-blue)](https://python-poetry.org)
+[![MCP](https://img.shields.io/badge/MCP-1.0-green)](https://github.com/anthropics/model-context-protocol)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+A Python [MCP](https://github.com/anthropics/model-context-protocol) server that exposes your local [Ollama](https://ollama.ai) models as tools for AI assistants like **Windsurf**, **VS Code**, **Claude Desktop**, and more.
+
+📚 **[Full Documentation](https://pblagoje.github.io/mcp-ollama-python/)**
+
+---
+
+## What It Does
+
+Connect your local LLMs to any MCP-compatible AI assistant. No cloud APIs needed.
+
+| Tool | What it does |
+|------|-------------|
+| `ollama_chat` | Chat with any local model (multi-turn, tool-calling) |
+| `ollama_generate` | Generate text completions |
+| `ollama_embed` | Create vector embeddings |
+| `ollama_list` | List installed models |
+| `ollama_show` | Inspect model details |
+| `ollama_pull` | Download new models |
+| `ollama_delete` | Remove models |
+| `ollama_ps` | List running models |
+
+## Quick Start
+
+**Prerequisites:** Python 3.10+, [Ollama](https://ollama.ai) running locally
+
+```bash
+pip install mcp-ollama-python
+```
+
+### Windsurf / VS Code
+
+Add to your MCP config (`mcp_config.json`):
+
+```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
+
+| Guide | Description |
+|-------|-------------|
+| [Installation](https://pblagoje.github.io/mcp-ollama-python/installation/) | Setup and prerequisites |
+| [Available Tools](https://pblagoje.github.io/mcp-ollama-python/tools/) | All tools with examples |
+| [Configuration](https://pblagoje.github.io/mcp-ollama-python/configuration/) | Environment variables, model config |
+| [Windsurf Integration](https://pblagoje.github.io/mcp-ollama-python/windsurf/) | Complete Windsurf setup guide |
+| [VS Code Integration](https://pblagoje.github.io/mcp-ollama-python/vscode/) | VS Code setup |
+| [Architecture](https://pblagoje.github.io/mcp-ollama-python/architecture/) | How it works, adding tools |
+| [Server Control](https://pblagoje.github.io/mcp-ollama-python/SERVER_CONTROL/) | Start/stop/manage the server |
+| [Interactive Manager](https://pblagoje.github.io/mcp-ollama-python/mcp_interactive/) | Menu-driven management UI |
+| [Development](https://pblagoje.github.io/mcp-ollama-python/development/) | Contributing, code quality |
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+<div align="center">
+
+Made with ❤️ using Python, Poetry, and Ollama
+
+</div>
+

mcp_ollama_python-1.0.4/README.md

@@ -0,0 +1,95 @@
+# 🦙 Ollama MCP Server (Python)
+
+**Supercharge your AI assistant with local LLM access**
+
+[![Python](https://img.shields.io/badge/Python-3.10+-blue)](https://python.org)
+[![Poetry](https://img.shields.io/badge/Poetry-1.0+-blue)](https://python-poetry.org)
+[![MCP](https://img.shields.io/badge/MCP-1.0-green)](https://github.com/anthropics/model-context-protocol)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+A Python [MCP](https://github.com/anthropics/model-context-protocol) server that exposes your local [Ollama](https://ollama.ai) models as tools for AI assistants like **Windsurf**, **VS Code**, **Claude Desktop**, and more.
+
+📚 **[Full Documentation](https://pblagoje.github.io/mcp-ollama-python/)**
+
+---
+
+## What It Does
+
+Connect your local LLMs to any MCP-compatible AI assistant. No cloud APIs needed.
+
+| Tool | What it does |
+|------|-------------|
+| `ollama_chat` | Chat with any local model (multi-turn, tool-calling) |
+| `ollama_generate` | Generate text completions |
+| `ollama_embed` | Create vector embeddings |
+| `ollama_list` | List installed models |
+| `ollama_show` | Inspect model details |
+| `ollama_pull` | Download new models |
+| `ollama_delete` | Remove models |
+| `ollama_ps` | List running models |
+
+## Quick Start
+
+**Prerequisites:** Python 3.10+, [Ollama](https://ollama.ai) running locally
+
+```bash
+pip install mcp-ollama-python
+```
+
+### Windsurf / VS Code
+
+Add to your MCP config (`mcp_config.json`):
+
+```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
+
+| Guide | Description |
+|-------|-------------|
+| [Installation](https://pblagoje.github.io/mcp-ollama-python/installation/) | Setup and prerequisites |
+| [Available Tools](https://pblagoje.github.io/mcp-ollama-python/tools/) | All tools with examples |
+| [Configuration](https://pblagoje.github.io/mcp-ollama-python/configuration/) | Environment variables, model config |
+| [Windsurf Integration](https://pblagoje.github.io/mcp-ollama-python/windsurf/) | Complete Windsurf setup guide |
+| [VS Code Integration](https://pblagoje.github.io/mcp-ollama-python/vscode/) | VS Code setup |
+| [Architecture](https://pblagoje.github.io/mcp-ollama-python/architecture/) | How it works, adding tools |
+| [Server Control](https://pblagoje.github.io/mcp-ollama-python/SERVER_CONTROL/) | Start/stop/manage the server |
+| [Interactive Manager](https://pblagoje.github.io/mcp-ollama-python/mcp_interactive/) | Menu-driven management UI |
+| [Development](https://pblagoje.github.io/mcp-ollama-python/development/) | Contributing, code quality |
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+<div align="center">
+
+Made with ❤️ using Python, Poetry, and Ollama
+
+</div>

{mcp_ollama_python-1.0.2 → mcp_ollama_python-1.0.4}/pyproject.toml

@@ -1,10 +1,12 @@
 [tool.poetry]
 name = "mcp-ollama-python"
-version = "1.0.2"
+version = "1.0.4"
 description = "Model Context Protocol server that proxies local Ollama to MCP clients like Windsurf and VS Code"
 authors = ["Pedja Blagojevic <pb@internetics.net>"]
 readme = "README.md"
 packages = [{include = "mcp_ollama_python", from = "src"}]
+license = "MIT"
+homepage = "https://github.com/pblagoje/mcp-ollama-python"
 
 [tool.poetry.dependencies]
 python = ">=3.10,<3.15"
@@ -17,6 +19,8 @@ tzdata = "^2024.1"
 
 [tool.poetry.scripts]
 mcp-ollama-python = "mcp_ollama_python.main:run"
+mcp-interactive = "mcp_ollama_python.scripts.mcp_interactive:main"
+mcp-server-control = "mcp_ollama_python.scripts.server_control:main"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.0.0"
@@ -26,6 +30,10 @@ pre-commit = "^4.5.1"
 black = "^26.1.0"
 flake8 = "^7.3.0"
 
+[tool.poetry.group.docs.dependencies]
+mkdocs = "^1.6.0"
+mkdocs-material = "^9.5.0"
+
 [tool.ruff]
 line-length = 100
 target-version = "py310"

{mcp_ollama_python-1.0.2 → mcp_ollama_python-1.0.4}/src/mcp_ollama_python/models.py

@@ -4,6 +4,7 @@ Core types and enums for Ollama MCP Server
 
 from enum import Enum
 from typing import Any, Dict, List, Optional
+
 from pydantic import BaseModel, Field
 
 

{mcp_ollama_python-1.0.2 → mcp_ollama_python-1.0.4}/src/mcp_ollama_python/ollama_client.py

@@ -3,9 +3,10 @@ Ollama HTTP client wrapper
 """
 
 import os
-import httpx
 from typing import Any, Dict, List, Optional, Union
 
+import httpx
+
 try:
     from mcp_ollama_python.models import (
         GenerationOptions,
@@ -160,9 +161,11 @@ class OllamaClient:
             data["options"] = options.model_dump(exclude_unset=True)
         return await self._post("/api/chat", data)
 
-    async def embed(self, model: str, input: Union[str, List[str]]) -> Dict[str, Any]:
+    async def embed(
+        self, model: str, input_text: Union[str, List[str]]
+    ) -> Dict[str, Any]:
         """Generate embeddings"""
-        return await self._post("/api/embed", {"model": model, "input": input})
+        return await self._post("/api/embed", {"model": model, "input": input_text})
 
     async def ps(self) -> Dict[str, Any]:
         """List running models"""