Release Notes v1.0.7 - Maintenance Release

🚀 What's New

Version Bump

• Version 1.0.7 - Incremented from 1.0.6 with stability improvements

🧹 Code Cleanup

• Removed deprecated Windows NSSM service installation scripts
  • Deleted scripts/win_ollama_service_install_nssm.md
  • Deleted scripts/win_ollama_service_install_nssm.ps1
  • These scripts are no longer maintained and have been replaced with better alternatives

🔧 Development Improvements

• VS Code Configuration
  • Added Python interpreter settings for isort extension
  • Fixed isort interpreter detection issues
  • Improved development environment setup

📦 Dependencies

• Updated Poetry lock file with latest compatible versions
• Refreshed dependency tree for better stability

🧪 Testing & Quality

• Minor test improvements and formatting fixes
• Updated example scripts for better clarity
• Code formatting consistency across the codebase

📚 Documentation

• Updated README and server control documentation
• Improved example scripts with better explanations

🔄 Breaking Changes

None - This is a cleanup release with no breaking API changes.

🛠️ Installation

pip install --upgrade mcp-ollama-python

🐛 Bug Fixes

• Fixed isort extension interpreter detection in VS Code
• Resolved development environment configuration issues

📝 Summary

v1.0.7 is a maintenance release focused on cleaning up deprecated code and improving the development experience. The core functionality remains unchanged, but the codebase is now cleaner and more maintainable.

Total changes: 24 files modified, 673 deletions, 237 additions (net -436 lines)

---

Previous version: v1.0.6
Release date: March 4, 2026

Enhancements to Prompt Set

Release Notes – Version 1.0.6

Enhancements to Prompt Set

• Added two new server prompts:
  • explain_code – Generates structured explanations for provided code snippets, with required arguments and a dedicated output template.
  • write_docstring – Produces docstrings following a consistent, well‑defined format, also with required arguments and a generation template.
• Strengthened the code_review prompt:
  • Now emphasizes correctness, security, and actionable findings.
  • Removed the outdated focus argument to streamline usage and reduce ambiguity.

Version Update

• Bumped package version to 1.0.6 to reflect the expanded prompt capabilities and internal improvements.

Server Robustness Improvements

• Improved handle_read_resource to better accommodate changes in the MCP SDK:
  • Now accepts resource descriptors provided as dictionaries containing a uri key.
  • Normalizes actual_uri to ensure consistent handling across SDK versions.
• Enhanced URI validation and error reporting for clearer diagnostics and more predictable behavior.

Introduce logging, input validation, and robustness improvements across the codebase.

Release Notes: v1.0.5

Package initialization & entrypoint

• Introduced a unified run entrypoint, added __version__, standardized logging initialization, and wrapped execution in a main() function with graceful KeyboardInterrupt and error‑handling paths.

Autoloader

• Added structured logging and stronger type annotations.
• Improved ToolRegistry behavior and made dynamic imports more resilient.
• Added validation and normalization of tool_definition objects.
• Enhanced handler discovery and added reporting for successfully loaded and failed modules.

Main server flow

• Centralized logging configuration and improved signal‑handling.
• Added defensive try/except guards around server startup, tool/resource loading, and prompt handler initialization.
• Clarified shutdown and cleanup sequencing, with safer console output.

Models

• Major Pydantic overhaul: new types, validators, and richer models for tools, tool calls, messages, results, and web fetch/search structures.
• Improved field documentation and added custom error‑string formatting.

Ollama client

• Added host/model/input validation and URL checks to reduce SSRF exposure.
• Introduced default timeouts and constants, improved HTTP response handling, and wrapped errors more consistently.
• Added request/response logging, context‑manager support, and stricter parameter validation.

Response formatter

• Strengthened JSON and Markdown formatting, including serialization‑error handling and markdown escaping.
• Added circular‑reference protection, recursion limits, and improved table/array rendering.

---

Overall, this release emphasizes observability, input validation, error resilience, and making the system’s components more defensive, predictable, and maintainable.

---

v1.0.4

docs: add GitHub Pages with MkDocs, restructure README

docs: add GitHub Pages with MkDocs, restructure README

- Set up MkDocs with Material theme for documentation site
- Add GitHub Actions workflow (docs.yml) to auto-deploy to gh-pages
- Slim down README.md to a promotional landing page with pip install
- Split detailed content into separate docs pages:
  - installation.md (end-user, pip-focused)
  - configuration.md (env vars, model config)
  - tools.md (all 8 tools with examples)
  - windsurf.md (full Windsurf integration guide)
  - vscode.md (VS Code setup)
  - architecture.md (autoloader, adding tools)
  - development.md (contributor setup, testing, building)
- Fix stale links in SERVER_CONTROL.md
- Add mkdocs + mkdocs-material to pyproject.toml docs group

Ollama MCP server + interactive test scripts.

Enabled mcp-ollama-python + mcp-interactive and mcp-server-control scripts.

Ollama MCP server.

MCP Ollama server for VS Code, Windsurf, etc...