Modernization & uv Migration - v3.0.0

v3.0.0 - Modernization & uv Migration

This is a major release with breaking changes. The Doxygen MCP server has been modernized with faster dependency management, cleaner documentation, and professional naming conventions.

⚠️ Breaking Changes

Installation & Configuration:

• New dependency manager: Migrated from pip to uv for faster, more reliable builds
• New installation command: uv sync (replaces pip install -e .)
• New entry point: uv run doxygen-mcp (old entry point removed)
• MCP server name: Now displays as "Doxygen" (was "doxygen-mcp")
• Python requirement: Now requires Python 3.11+ (was 3.8+)

MCP Client Configuration:

{
  "mcpServers": {
    "doxygen": {
      "command": "uv",
      "args": ["--directory", "/path/to/doxygen-mcp", "run", "doxygen-mcp"]
    }
  }
}

✨ Improvements

• 📚 Documentation: Consolidated from 9 files to 6 with clearer structure
  • Quick Start guide in README.md
  • Comprehensive developer guide in USING.md
  • Complete troubleshooting in BUGS.md
• ⚡ Performance: Faster dependency resolution with uv
• 🔒 Reproducibility: Lock file (uv.lock) ensures consistent builds
• 📦 Modern Packaging: Follows PEP 517/518 standards
• 🎨 Professional Naming: Server displays as "Doxygen" in MCP clients

🔄 Migration from v2.0.0

For Existing Users:

1. Update repository:

   git pull origin master

2. Remove old virtual environment:

   rm -rf .venv

3. Install with uv:

   uv sync

4. Update MCP client configuration (see Breaking Changes above)

5. Restart your MCP client

See USING.md for complete migration instructions.

📦 Installation (New Users)

Prerequisites:

• Python 3.11+
• uv package manager
• Doxygen

Install:

git clone https://github.com/Positronikal/doxygen-mcp.git
cd doxygen-mcp
uv sync

Configure in Claude Desktop:

{
  "mcpServers": {
    "doxygen": {
      "command": "uv",
      "args": ["--directory", "/full/path/to/doxygen-mcp", "run", "doxygen-mcp"]
    }
  }
}

🛠️ Tools Available

All 7 Doxygen MCP tools remain unchanged:

• create_doxygen_project - Initialize documentation projects
• generate_documentation - Generate docs from source code
• scan_project - Analyze project structure
• validate_documentation - Check coverage and warnings
• create_doxyfile - Generate configuration files
• check_doxygen_install - Verify Doxygen installation
• suggest_file_patterns - Get file pattern recommendations

📄 License

GNU General Public License v3.0 or later (GPLv3+)

---

Questions? Open an issue or see BUGS.md for troubleshooting.