v8.13.3 - Critical Patch Release
🚨 MCP Memory Tools Restored
This critical patch fixes a v8.12.0 regression that completely broke all MCP memory operations.
🐛 Issue Fixed
All MCP Memory Tools Broken
- Error:
KeyError: 'message'when calling any MCP memory tool - Impact: MCP tools (store, retrieve, search, delete) completely non-functional since v8.12.0
- Symptoms: "Error storing memory: 'message'" in Claude Code/Desktop
🔍 Root Cause
v8.12.0 MemoryService Architecture Regression
The MemoryService refactoring changed response format:
- MemoryService returns:
{success: bool, memory: {...}} - MCP tools expect:
{success: bool, message: str, content_hash: str} - Result: MCP protocol tries to access missing 'message' field → KeyError
Why It Persisted:
- ✅ HTTP API works fine (doesn't need these specific fields)
- ✅ Integration tests passed (only tested HTTP, not MCP protocol)
- ❌ No MCP protocol integration tests to catch this
✅ Changes
mcp_server.py (lines 173-206):
- ✅ Transform MemoryService response to MCP TypedDict format
- ✅ Extract
content_hashfrom nested memory object - ✅ Add descriptive
messagefield for MCP protocol - ✅ Handle 3 response cases:
- Failure: Return error message
- Chunked: Return chunk count and hashes
- Single: Return content hash
🎯 Result
MCP memory tools now work correctly:
- ✅ Proper
messagefield in responses - ✅ Correct
content_hashextraction - ✅ Descriptive error messages
- ✅ Chunked memory support maintained
⚠️ User Action Required
Restart MCP Server to Load Fix:
Claude Code:
# Type this command:
/mcpClaude Desktop:
- Restart the application
This will:
- Terminate old MCP server process (running broken code)
- Start new MCP server with fix
- MCP memory tools will work again
📊 Technical Details
- Introduced: v8.12.0 MemoryService architecture (#176)
- Affected: All MCP memory operations (store, retrieve, search, delete)
- HTTP API: Unaffected (uses different response format)
- Test Gap: Need MCP protocol integration tests
📚 Full Changelog
See CHANGELOG.md for complete details.
🔗 Related
- Previous: v8.13.2 (sync script fix)
- Regression from: v8.12.0 MemoryService architecture
- Issue: Need MCP integration tests (#190 related)