Redmine MCP Server

# Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ## [0.3.1] - 2025-06-27 ### Fixed - **Documentation Accuracy**: Corrected Claude MCP verification commands - Replaced invalid `claude mcp test redmine` with `claude mcp list` - Added `/mcp` slash command as alternative verification method in Claude Code - Improved installation verification instructions ## [0.3.0] - 2025-06-27 ### Added - 📋 **Environment Variables Reference Table** - Comprehensive documentation of all configuration options - 🔄 **Reinstallation Guide** - Complete step-by-step instructions for updating MCP server - 🔧 **Enhanced Log Level Management** - Support for both project-specific and legacy environment variables - ⚡ **FastMCP Compatibility** - Automatic case conversion and synchronization with FastMCP log levels ### Changed - **Environment Variable Priority System**: 1. `REDMINE_MCP_LOG_LEVEL` (highest priority - project-specific) 2. `LOG_LEVEL` (backward compatibility) 3. `INFO` (default) - **Configuration Loading Order**: Ensure configuration loads before FastMCP initialization - **Documentation Structure**: Added dedicated updating section and improved environment variable docs ### Fixed - **FastMCP Startup Errors**: Resolved case sensitivity issues with log level environment variables - **Configuration Race Condition**: Fixed issue where FastMCP read environment variables before they were properly set - **Log Level Validation**: Improved error messages for invalid log level values ### Technical Improvements - Enhanced config.py with robust log level resolution logic - Improved server.py initialization sequence - Better error handling and validation - Backward compatibility maintained for existing installations ## [0.2.0] - 2025-06-27 ### Added - 🎯 **Time Tracking Support** - Record working hours when adding issue notes - 🏗️ **Parent-Child Issue Relationships** - Full support for issue hierarchies - 🎯 **Name Parameter Support** - Use names instead of IDs for priorities, statuses, trackers - 🧠 **Smart Caching System** - Multi-domain cache with automatic refresh - 👥 **Enhanced User Management** - Search and manage users by name/login - ⚡ **Cache Refresh Tool** - Manual cache refresh with statistics ### Enhanced Features - **Name-based Parameters**: All major tools now support name parameters - Priority names (e.g., "High", "Normal", "Low") - Status names (e.g., "In Progress", "Resolved") - Tracker names (e.g., "Bug", "Feature", "Support") - User names and login names - **Time Logging**: `add_issue_note` now supports time tracking - Activity names and IDs - Flexible date specification - Private/public note options - **Intelligent Error Messages**: Show available options when invalid names provided ### Technical Improvements - Multi-domain cache file support (`~/.redmine_mcp/cache_{domain}_{hash}.json`) - 24-hour automatic cache refresh - Comprehensive helper functions for ID lookups - Enhanced environment variable configuration ## [0.1.0] - 2025-06-26 ### Added - 🎉 **Initial Release** of Redmine MCP Server - ✅ **Complete MCP Server Architecture** implementation - 🔧 **22 Core MCP Tools** for comprehensive Redmine integration - 📋 **Issue Management Features** - `get_issue` - Get detailed issue information - `create_new_issue` - Create new issues - `update_issue_status` - Update issue status - `update_issue_content` - Update issue content - `add_issue_note` - Add issue notes - `assign_issue` - Assign/unassign issues - `close_issue` - Close issues - 🗂️ **Project Management Features** - `get_projects` - Get project lists - `list_project_issues` - List project issues - `get_issue_statuses` - Get issue statuses - `get_trackers` - Get tracker lists - `get_priorities` - Get priority lists - `get_time_entry_activities` - Get time tracking activities - `get_document_categories` - Get document categories - 👥 **User Management Features** - `search_users` - Search users by name/login - `list_users` - List all users - `get_user` - Get user details - 🔍 **Search Features** - `search_issues` - Search issues by keywords - `get_my_issues` - Get issues assigned to current user - 🔧 **System Tools** - `server_info` - Display server information - `health_check` - Health check and diagnostics - `refresh_cache` - Manual cache refresh - 🔐 **Complete Authentication and Permission Management** - 🛡️ **Data Validation and Error Handling** - 🐳 **Docker Test Environment Support** - 🧪 **Comprehensive Test Suite** (100% test coverage) - 📚 **Complete Documentation and Usage Guidelines** - 🔗 **Claude Code Integration Support** ### Technical Implementation - Built with FastMCP framework - Python 3.12+ support - UV package manager integration - Complete Redmine REST API client - Environment variable configuration management - User-friendly error messages and interface ### Documentation - 📖 README.md - Project overview and quick start guide - 🚀 Installation and setup instructions - 💡 Usage examples and best practices - 📋 Complete tool reference - 🧪 Testing guides and examples ### Compatibility - Redmine 4.0+ (recommended 5.0+) - Claude Code MCP integration - Cross-platform support (Windows, macOS, Linux) --- ## Version Format Guidelines - **Added** - New features - **Changed** - Changes in existing functionality - **Deprecated** - Soon-to-be removed features - **Removed** - Removed features - **Fixed** - Bug fixes - **Security** - Security-related changes [Unreleased]: https://github.com/snowild/redmine-mcp/compare/v0.3.1...HEAD [0.3.1]: https://github.com/snowild/redmine-mcp/compare/v0.3.0...v0.3.1 [0.3.0]: https://github.com/snowild/redmine-mcp/compare/v0.2.0...v0.3.0 [0.2.0]: https://github.com/snowild/redmine-mcp/compare/v0.1.0...v0.2.0 [0.1.0]: https://github.com/snowild/redmine-mcp/releases/tag/v0.1.0