Sdkman MCP

🚀 SDKMAN Interactive Console

The SDKMAN Interactive Console is an enhanced interface tool for SDKMAN, designed to help users more easily browse, filter, and install various SDKs. This tool enhances the user experience by executing SDKMAN commands, parsing and formatting outputs, and providing an interactive selection interface.

🚀 Quick Start

The SDKMAN Interactive Console is a powerful tool that simplifies the process of managing SDKs. It offers an interactive way to select and install SDK versions, making it easier for developers to work with different SDKs.

✨ Features

• Interactive Version Selection: A version selection feature with formatted display.
• Version List Parsing: Capable of parsing SDK version lists and supporting searches for specific versions.
• Standard SDKMAN Functions: Including listing SDKs, installing SDKs, and viewing the current default SDK.

📦 Installation

Prerequisites

1. Install Python 3.6 or a higher version.
2. Ensure that SDKMAN is correctly installed and configured in the ~/.sdkman directory, or set the environment variable SDKMAN_DIR.
3. The system must provide a Bash shell to run SDKMAN commands.

Installation Steps

# Clone the repository to your local machine
git clone <repository-url>
cd sdkman-interactive-cli

💻 Usage Examples

Using as a Python Module

# Example code: Install a specified candidate SDK and optionally search for a version
from sdkman_interactive import sdk_interactive_install

sdk_interactive_install('candidate', search_version='specific_version')

Command-Line Interface (CLI)

Installation Script Examples:

# Install any SDKMAN candidate via the script
python3 path/to/install_sdk.py candidate

# Install a specific version of JDK
python3 path/to/install_jdk.py --version specific_version

Main CLI Commands:

• list: List all available SDKs.
• install <candidate>: Install the specified candidate SDK.
• current: View the current default SDK.

📚 Documentation

Integration with AI Assistant (MCP Protocol)

This tool supports integration with an AI assistant via the MCP protocol, providing automated command execution capabilities. Here is an example configuration:

Configuration on Claude Desktop:

1. Open the .config/claude/settings.json file in your user's home directory.
2. Add the following configuration content:

{
    "experimental": {
        "mcp_integration": true,
        "sdkman_path": "~/.sdkman"
    }
}

Example Output of Usage

Here is an example output of the interactive installation interface:

Note: >>> in the Use column indicates the current default version.

Please select a version number (or enter 'q' to exit):

📄 API Reference

This module provides the following functional functions:

• sdk_interactive_install(candidate, search_version=None): For interactive SDK installation.
• parse_sdk_versions(output, search_version=None): Parse and filter the SDK version list.
• Other standard SDKMAN command functions.

🔧 Technical Details

This tool achieves its functionality through the following steps:

1. Execute SDKMAN commands.
2. Parse and format command outputs.
3. Provide an interactive selection interface.
4. Handle installation confirmation steps.

Troubleshooting

Common issues and solutions:

• SDKMAN Not Found: Ensure that SDKMAN is correctly installed in the ~/.sdkman directory, or set the environment variable SDKMAN_DIR.
• Permission Denied: Check if the SDKMAN script has execution permissions.
• Command Not Found: Confirm that the Bash shell is installed on the system (used to run SDKMAN commands).
• MCP Integration Issues: Ensure that the AI assistant has the appropriate permissions to execute commands.

🤝 Contribution Guidelines

Contributions are welcome! Please feel free to submit a Pull Request to add features or fix issues to the project.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

🙏 Acknowledgments

Thanks to the following projects and contributors:

• SDKMAN - Software Development Kit Manager
• All contributors to this project