Skip to content

LDAP Assistant MCP v0.2.0

Choose a tag to compare

@droideck droideck released this 01 Jan 05:26
· 32 commits to main since this release

Release v0.2.0 - Health, Replication, Performance & Index Diagnostics

Added

Health & Diagnostics

  • first_look() - Multi-server quick health overview that provides comprehensive assessment across all configured servers including connectivity, replication, cache efficiency, disk space, and SSL certificate expiration
  • run_healthcheck() - Full health check equivalent to dsctl <instance> healthcheck, examining configuration, backends, security, replication, plugins, certificates, disk space, and more
  • list_healthchecks() - List all available health checks that can be run
  • list_healthcheck_errors() - List all known DSLE error codes with severity and descriptions

Replication Diagnostics

  • get_replication_status() - Comprehensive replication status including replica role, RUV analysis, and all agreement statuses with issue detection
  • get_replication_topology() - Map complete replication topology across all configured servers, identifying single points of failure and orphaned replicas
  • check_replication_lag() - Analyze replication lag by comparing CSN values between supplier and consumers
  • list_replication_conflicts() - Find all conflict entries and glue entries that need resolution
  • get_agreement_status() - Detailed status for specific or all replication agreements

Performance Diagnostics

  • get_performance_summary() - Combined performance overview with prioritized findings from all categories
  • get_cache_statistics() - Analyze database and entry cache efficiency with health assessments
  • get_connection_statistics() - Analyze connection patterns, file descriptor utilization, and connection states
  • get_operation_statistics() - Operation counts by type including binds, searches, modifications, and errors
  • get_thread_statistics() - Worker thread utilization and contention detection
  • get_resource_utilization() - System resource usage including memory, CPU, and disk

Index Analysis

  • list_indexes() - List all configured indexes including regular and VLV indexes per backend
  • analyze_index_configuration() - Compare current indexes against recommended best practices with remediation commands
  • find_unindexed_searches() - Parse access logs to identify search patterns causing unindexed searches (local servers only)

Configuration Analysis

  • get_server_configuration() - Dynamically fetch all cn=config attributes with optional pattern filtering
  • compare_server_configurations() - Compare configuration between two servers to identify differences
  • list_plugins() - List all configured plugins with enabled/disabled filtering
  • get_backend_configuration() - Backend-specific configuration including cache settings, statistics, and replication status

Privacy Mode

  • Added LDAP_MCP_EXPOSE_SENSITIVE_DATA environment variable for controlling data exposure
  • Privacy sanitization for all tool outputs when privacy mode is enabled
  • Server names, DNs, hostnames, and suffixes are anonymized in privacy mode

Changed

  • Enhanced multi-server support with consistent server_name parameter across all tools
  • Improved error handling with structured findings including severity, impact, and remediation steps
  • All diagnostic tools now return findings in a consistent format with severity levels (CRITICAL, HIGH, MEDIUM, LOW, INFO)

Notes

  • Some health and performance checks require local server access (is_local=True with serverid) for full functionality:
    • Disk space monitoring
    • Certificate expiration checking
    • Access log analysis for unindexed searches
    • Process memory and CPU monitoring