bump: update version from 0.3.0 to 0.3.1

- Fix Home Manager context handling in MCP interface
- Implement proper type checking for string contexts from MCP
- Fix cascading failures in tool registration
- Add RELEASE_NOTES.md with detailed explanation of fixes

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: jamesbrink

CLAUDE.md

@@ -299,7 +299,7 @@ Official repository: [https://github.com/utensils/mcp-nixos](https://github.com/
   - Docker image includes pre-cached data for immediate startup
   - Build with pre-cache: `docker build -t mcp-nixos .`
   - Deployed on Smithery.ai as a hosted service
-- Interactive CLI (deprecated from v0.3.0):
+- Interactive CLI (deprecated from v0.3.1):
   - For manual testing, use a JSON-capable HTTP client like HTTPie or curl
   - Example: `echo '{"type":"call","tool":"nixos_search","params":{"query":"python"}}' | nc localhost 8080`
 - Development:

RELEASE_NOTES.md

@@ -0,0 +1,61 @@
+# MCP-NixOS: v0.3.1 Release Notes
+
+## Overview
+
+MCP-NixOS v0.3.1 is a patch release that fixes critical issues with the Home Manager and NixOS tools when used through Claude's Model Context Protocol (MCP) interface.
+
+## Changes in v0.3.1
+
+### 🐛 Bug Fixes
+
+- **Fixed Home Manager context handling in MCP interface**: Resolved issues where Home Manager tools would fail with `'str' object has no attribute 'request_context'` error when accessed through Claude's MCP interface
+- **Improved context type validation**: Added proper type checking with `isinstance(ctx, str)` to handle both server request contexts and string contexts from MCP
+- **Enhanced error handling in tool registration**: Modified MCP tool registration to dynamically import the proper context when string contexts are passed
+- **Restored dependency lock file**: Added `uv.lock` to ensure consistent dependencies across all environments, fixing missing `psutil` dependency issues
+
+## Technical Details
+
+The fundamental issue occurred in the context handling within the MCP-NixOS integration:
+
+1. **Inconsistent Context Types**: The Home Manager tools were originally designed to handle `request_context` objects from the internal server, but when called through Claude's MCP interface, they received a string context instead.
+
+2. **Type Mismatch Error**: This led to the error `'str' object has no attribute 'request_context'` when the tools tried to access `ctx.request_context` on a string.
+
+3. **Two-Layer Context Problem**: The issue existed in both:
+   - The direct tool functions 
+   - The MCP tool registration wrappers
+
+The fix required implementing proper type checking in both the tool functions themselves and in their MCP registration wrappers, along with appropriate handling for string contexts by dynamically importing the proper context object.
+
+## Installation
+
+```bash
+# Install with pip
+pip install mcp-nixos==0.3.1
+
+# Install with uv
+uv pip install mcp-nixos==0.3.1
+
+# Install with uvx
+uvx mcp-nixos==0.3.1
+```
+
+## Usage
+
+Configure Claude to use the tool by adding it to your `~/.config/claude/config.json` file:
+
+```json
+{
+  "tools": [
+    {
+      "path": "mcp_nixos",
+      "default_enabled": true
+    }
+  ]
+}
+```
+
+## Contributors
+
+- James Brink (@utensils)
+- Sean Callan (Moral Support)

mcp_nixos/__init__.py

@@ -12,12 +12,12 @@
         __version__ = version("mcp-nixos")
     except PackageNotFoundError:
         # Package is not installed, use a default version
-        __version__ = "0.3.0"
+        __version__ = "0.3.1"
 except ImportError:
     # Fallback for Python < 3.8
     try:
         import pkg_resources
 
         __version__ = pkg_resources.get_distribution("mcp-nixos").version
     except Exception:
-        __version__ = "0.3.0"
+        __version__ = "0.3.1"

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mcp-nixos"
-version = "0.3.0"
+version = "0.3.1"
 description = "Model Context Protocol server for NixOS, Home Manager, and nix-darwin resources"
 readme = "README.md"
 authors = [

tests/test_version.py

@@ -47,7 +47,7 @@ def test_version_fallback_package_not_found(mock_version):
     import mcp_nixos
 
     # Check that the default version is used
-    assert mcp_nixos.__version__ == "0.3.0"
+    assert mcp_nixos.__version__ == "0.3.1"
     mock_version.assert_called_once_with("mcp-nixos")
 
 
@@ -80,5 +80,5 @@ def test_version_ultimate_fallback(mock_get_distribution, _):
     import mcp_nixos
 
     # Check that the default version is used when everything fails
-    assert mcp_nixos.__version__ == "0.3.0"
+    assert mcp_nixos.__version__ == "0.3.1"
     mock_get_distribution.assert_called_once()