MCP Claude Code v0.5.1

Fixed

• Test Suite Compatibility
  • Updated hidden files tests to reflect new .git directory access behavior
  • Fixed test expectations in test_various_hidden_files and test_real_world_project_paths
  • Tests now correctly expect .git paths to be allowed instead of excluded
  • Replaced .git exclusion test cases with node_modules exclusion test cases

MCP Claude Code v0.4.0

Added

• Persistent Shell Session Support (32769b5)
  • New BashSession class for managing persistent shell environments with tmux
  • SessionManager and SessionStorage for comprehensive session lifecycle management
  • Session-based execution mode with environment persistence and working directory tracking
  • Support for interactive commands with is_input and blocking parameters
  • Command history tracking and session isolation
• Resource Management and Cleanup (4c4a59d)
  • Background cleanup thread for periodic session expiration checks every 2 minutes
  • Signal handlers for graceful shutdown (SIGTERM, SIGINT)
  • Atexit handler for cleanup during normal termination
  • Reduced default session TTL from 30 to 5 minutes for aggressive cleanup
  • Session storage metrics and logging for cleanup operations
• Enhanced Cross-Platform Support (184c2f7)
  • New CommandExecutor class for Windows-compatible shell command execution
  • Automatic platform detection with tmux availability checking
  • Support for multiple shell types (cmd, powershell, wsl) on Windows
  • Platform-specific command formatting and execution logic
• Project System Prompt Enhancements (363f06f)
  • Factory function create_project_system_prompt for generating project-specific prompts
  • Manual project system prompt registration for on-demand access
  • Improved code organization and flexibility in prompt generation

Changed

• BREAKING CHANGE: Shell Execution Architecture (bf3233a)
  • Replaced CommandExecutor with BashSessionExecutor for all shell operations
  • All shell tools now use persistent sessions by default
  • Updated run_command tool interface with new session parameters
  • CommandResult now includes additional execution metadata
• BREAKING CHANGE: Tool Parameter Handling (bc52019)
  • Migrated all tool parameters to TypedDict and Unpack for improved type safety
  • Consolidated parameter type definitions at module level
  • Enhanced IDE support and runtime type checking
  • Removed redundant parameter validation in favor of Pydantic handling
• Session ID Handling Improvements (4263df1, 154a817)
  • Changed default session_id from None to empty string for consistency
  • Simplified session_id validation logic
  • Removed PROMPT_TEST echo command from session initialization
  • More predictable session handling behavior

Removed

• Metadata System Simplification (2cae74e)
  • Removed complex PS1 metadata system for command tracking
  • Eliminated CmdOutputMetadata class and PS1 prompt generation/parsing
  • Simplified CommandResult class to focus on core output
  • Improved reliability across different shell environments
• DocumentContext Removal (db23971)
  • Removed DocumentContext class and all related functionality
  • Simplified codebase by removing redundant path tracking
  • Permission management now handled solely by PermissionManager
• Legacy Command Executor (bf3233a)
  • Removed old CommandExecutor in favor of unified BashSessionExecutor
  • Consolidated shell execution logic into session-based approach

Enhanced

• Command Output Isolation (46c6c42)
  • Prevented command output accumulation in persistent sessions
  • Added automatic screen clearing and history management
  • Ensured clean execution context for sequential commands
• Platform-Specific Tool Registration (184c2f7)
  • Automatic selection of appropriate run_command implementation
  • Seamless fallback between tmux-based and Windows-compatible execution
  • Maintained consistent tool interface across platforms

Refactoring

• Improved Shell Execution Mode (f862a6f)
  • Added subprocess execution mode to BashSessionExecutor
  • Enhanced flexibility in execution strategy selection
• Code Quality and Type Safety (bc52019)
  • Comprehensive migration to modern Python type annotations
  • Improved developer experience with better IDE support
  • Reduced boilerplate validation code

MCP Claude Code v0.3.4

Added

• New release script and process improvements (49c7deb)

Refactored

• Tool Handler Architecture (b1f5bda)

  • Simplified tool handler methods by using get_context() dependency injection
  • Removed explicit MCPContext parameter from all tool handler signatures
  • Improved code organization and reduced boilerplate across all tool implementations
  • Maintained functionality while making handler signatures cleaner and more consistent

• FastMCP Migration (90a1419)

  • Updated all imports from mcp.server.fastmcp to fastmcp for improved consistency
  • Refactored tool parameter definitions to use pydantic Field annotations
  • Replaced deprecated parameter schema definitions with typed parameters
  • Enhanced type safety with TypedDict for complex parameter types
  • Added validation constraints through Field annotations

• Test Suite Cleanup (801efbf)

  • Removed obsolete parameter schema validation tests following pydantic migration
  • Cleaned up deprecated mcp_description method tests
  • Simplified test suites to focus on core functionality rather than schema validation
  • Retained essential tool property assertions for name and description validation

MCP Claude Code v0.3.3

No release notes found for version 0.3.3

MCP Claude Code v0.3.2

Fixed

• Project System Prompt Closure Bug
  • Fixed critical closure bug in project system prompt registration where all prompts incorrectly used the last project path instead of their respective project paths
  • Multiple projects configured in MCP settings now correctly generate unique system prompts for each project
  • Replaced problematic closure with factory function pattern to ensure proper variable capture
  • Resolves issue where system prompts for all projects would reference 'claude-code-provider-proxy' regardless of the actual project being used

Added

• Comprehensive Test Suite for Project System Prompts
  • Added tests/test_prompts.py with 4 comprehensive test cases to prevent regression
  • Tests cover multiple project registration, single project registration, no projects scenario, and project basename handling
  • Includes specific test case that detects the closure bug to prevent future regressions
  • Mock-based testing approach ensures reliable verification of prompt generation functionality

MCP Claude Code v0.3.1

Fixed

• Todo ID Validation Compatibility (da8295d)
  • Fixed todo ID validation to accept numeric IDs (integers and floats) in addition to strings
  • Resolves JSON parsing compatibility issue where numeric strings are automatically converted to integers
  • All IDs are now normalized to strings for consistent internal storage
  • Improved validation error messages for better debugging experience

Maintenance

• Code Quality Improvements (626ebec)
  • Removed unused imports and functions across multiple modules
  • Simplified validation.py by removing deprecated functions
  • Fixed linting issues including f-string formatting
  • Updated dependencies in uv.lock file
• Documentation Updates (fc688ec)
  • Updated example documentation with latest functionality demonstrations
  • Added cross-references to tutorial documentation for version 0.3 features

MCP Claude Code v0.3.0

Added

• TODO Management System (3f146ed)
  • Added TodoReadTool and TodoWriteTool for session-based task tracking
  • Implemented TodoStorage class for in-memory session-based storage
  • Support for todo items with status (pending/in_progress/completed) and priority (high/medium/low)
  • Session ID validation and isolation for secure multi-session support
  • Comprehensive test suite covering unit, integration, and validation scenarios
• Project Path Support and Prompt System (2833d07)
  • Added new --project CLI argument to specify project paths for prompt generation
  • Refactored prompts into separate modules under mcp_claude_code/prompts/
  • Added PROJECT_SYSTEM_PROMPT for project-specific system prompt generation
  • Added utility functions for directory structure and git information extraction
  • Enhanced GitPython dependency for improved git integration
• MultiEdit Tool for Atomic Multi-File Operations (2cd71bb)
  • Implemented atomic multi-edit operations with transaction semantics
  • Sequential edit application where each edit operates on previous results
  • Strict validation including exact string matching and expected replacement counts
  • File creation capability when first edit has empty old_string
  • Comprehensive diff generation and error handling
• Comprehensive Tutorial Documentation (d71aea7)
  • Added new TUTORIAL.md with detailed instructions for advanced features
  • Project-specific system prompt application via Claude Desktop UI
  • Automated commands for context management and task continuity
  • Practical workflow scenarios and TODO management integration

Enhanced

• TODO System Improvements (f5c2766)
  • Added latest session tracking and auto-continue functionality
  • Renamed continue_from_last_todo_list to continue_todo_by_session_id for clarity
  • Added continue_latest_todo function for automatic session detection
  • Enhanced TodoStorage with timestamp tracking for session management
  • Added find_latest_active_session method for locating recent sessions
• Project TODO Reminder System (ab3438d)
  • Implemented formatted todo list reminders for active sessions
  • Added empty state handling with PROJECT_TODO_EMPTY_REMINDER
  • Status indicators ([ ], [~], [✓]) and priority indicators (🔴, 🟡, 🟢)
  • Session isolation and comprehensive test coverage (569 lines)
• Tool Documentation and Usability (Multiple commits)
  • Enhanced agent tool description with detailed usage guidelines (a989b39, 223c9d1)
  • Improved batch tool description with usage examples and scenarios (70266ff)
  • Enhanced grep_ast tool description with AST context examples (81b6658)
  • Updated thinking tool description with detailed use cases (c829dbf)
  • Clarified filesystem tool documentation for better user experience (ce6b09f, 9d5f144)

Changed

• Tool Renaming and Consistency (Multiple commits)
  • Renamed Jupyter notebook tools: 'read_notebook' → 'notebook_read', 'edit_notebook' → 'notebook_edit' (1be13ea)
  • Renamed 'edit_file' tool to 'edit' for consistency (8404eee)
  • Updated all references and documentation to reflect new naming conventions
• Installation and Documentation Improvements (Multiple commits)
  • Completely rewrote installation guide with detailed instructions (56f28c3)
  • Updated INSTALL.md with improved project path configuration instructions (d71aea7, 8053705)
  • Added recommendation for setting projects individually for better system prompt generation
  • Simplified path parameter documentation and emphasized project path importance

Removed

• Deprecated Tools and Features (a1ee681)
  • BREAKING CHANGE: Removed run_script and script_tool functionality
  • Deleted implementation files and removed tool registration
  • Functionality consolidated into core run_command tool
• Deprecated File Operations (d893f8b)
  • Removed GetFileInfoTool and all related references
  • Cleaned up batch tool and filesystem tool integrations
• Outdated Documentation (Multiple commits)
  • Removed deprecated documentation files (USEFUL_PROMPTS.md, debug.md, migration guides) (8163f08)
  • Removed outdated system prompt documentation file (4eb866a)
  • Cleaned up redundant installation steps and outdated recommendations (42e7a69, 8be1a90)

Refactoring

• Code Quality and Formatting (49b4013)
  • Applied consistent code formatting and style improvements across codebase
  • Normalized whitespace, standardized quote usage, improved parameter alignment
  • Enhanced docstring formatting and removed unnecessary code complexity
• Configuration and Structure (155992d)
  • Reorganized pyproject.toml configuration sections for better organization
  • Moved pytest.ini_options section and removed redundant configurations
• Tool Parameter Clarity (6a14807)
  • Clarified session_id description to specify timestamp in seconds
  • Updated tool descriptions for better developer guidance

Documentation

• Enhanced Installation and Configuration (d71aea7, 56f28c3)
  • Multiple installation methods (uvx, pip/uv, development)
  • Detailed configuration options with practical examples
  • Agent tool setup instructions and performance optimization tips
  • Troubleshooting section and development procedures
• README Updates (8ca5e04)
  • Added todo_write and todo_read commands to feature table
  • Updated tool references and removed outdated recommendations
• Cross-Reference Integration
  • Added cross-references between installation and tutorial documents
  • Improved parameter table formatting and descriptions

MCP Claude Code v0.2.2

Added

• Added command timeout configuration with --command-timeout CLI parameter (099401c)
  • Configurable timeout for shell command execution with default of 120 seconds
  • Increased default timeout from 30s to 120s for more reliable long-running operations
  • Enhanced shell tool reliability for complex command execution scenarios

Enhanced

• Improved error handling for network-related command execution (099401c)
  • Added handle_connection_errors decorator to gracefully handle client disconnections
  • Prevents MCP server crashes when running network-related commands that could cause disconnections
  • Enhanced connection stability for shell tools (run_command, run_script, script_tool)
  • Improved ToolContext logging to silently handle connection errors

Changed

• Optimized system prompt format and removed redundant instructions (f57e015)
  • Removed outdated sections from system prompt to improve efficiency
  • Leveraged Claude 4's enhanced capabilities to reduce unnecessary guidance
  • Streamlined prompt structure for better performance and clarity

Fixed

• Cleaned up code formatting by removing trailing whitespace (099401c)
  • Improved code quality and consistency across the codebase
  • Applied consistent formatting standards

MCP Claude Code v0.2.1

Fixed

• Added proper single quote escaping for shell commands (2313d99)
  • Fixed command execution failures when commands contain single quotes
  • Modified _execute_command method to escape single quotes by replacing them with '\''
  • Added logging for original and escaped commands to assist with debugging
  • Added comprehensive tests for various quote patterns in shell commands
  • Tests verify proper handling of commands containing single quotes, double quotes, and mixed quote patterns

MCP Claude Code v0.2.0

Added

• Added batch tool availability to dispatch_agent (c7bc6a8)
  • Enhanced agent capabilities by adding BatchTool to available tools
  • Enables batch processing for improved agent performance
  • Allows for concurrent execution of multiple operations

Changed

• Renamed read_files tool to read with improved functionality (42d8e94)
  • Simplified interface with single file_path parameter
  • Added line number display in output (cat -n format)
  • Added offset and limit parameters for reading specific line ranges
  • Added line truncation for very long lines
  • Improved error handling and parameter validation
• Enforced absolute path requirement in agent prompts (c3fe452)
  • Added validation for absolute paths in dispatch_agent prompts
  • Improved error messages with usage examples
  • Enhanced reliability for filesystem operations
• Renamed edit_file tool to edit throughout documentation and code (10cfe12)
  • Updated all references for consistency
  • Improved parameter handling and validation
  • Enhanced error messages

Fixed

• Removed outdated docstring section in agent_tool.py (c30ad80)
  • Eliminated obsolete information about args and returns
  • Maintained core tool functionality description
• Updated directory verification tool reference in write.py docs (fb36e12)
  • Changed LS tool reference to directory_tree tool for accuracy
  • Aligned documentation with actual tool naming conventions

Documentation

• Added example for dispatching multiple agents in batch operations (8ed8769)
  • Demonstrated concurrent agent dispatch for information retrieval
  • Added batch operations as valid use case for agent operations
• Clarified batch tool usage guidelines and added examples (9e14410)
  • Emphasized related changes vs. independent operations
  • Distinguished between simple mechanical changes and complex validations
  • Added practical usage scenarios and examples
• Refactored dispatch_agent documentation (81292c8)
  • Simplified and consolidated usage guidelines
  • Updated concurrency recommendations for batch capabilities
  • Improved readability with clearer section organization