What is Sdkman Mcp

sdkman-mcp is a Model Context Protocol (MCP) server designed for SDKMAN. It provides an interactive command-line interface to help users browse, filter, and install various Software Development Kits (SDKs) from any command line environment.

Use cases

Use cases for sdkman-mcp include installing specific versions of SDKs interactively, managing different SDK versions for various projects, and simplifying the setup process for development environments.

How to use

To use sdkman-mcp, you can either utilize it as a Python module or through the command line interface. Install the desired SDK by calling the appropriate functions or scripts, such as ‘sdk_interactive_install’ for interactive installations or using provided scripts for specific SDKs.

Key features

Key features of sdkman-mcp include interactive version selection, version filtering by keywords, support for all SDKMAN candidates (like Java, Kotlin, Gradle), a comprehensive command-line interface, and a user-friendly display of version information.

Where to use

sdkman-mcp can be used in software development environments where managing multiple SDKs is necessary, including but not limited to Java development, Kotlin projects, and Gradle builds.

SDKMAN Interactive CLI

An interactive command-line interface for SDKMAN (Software Development Kit Manager), making it easier to browse, filter, and install SDKs.

中文文档

Features

• Interactive version selection with formatted display
• Version filtering by keyword (e.g., “21” for Java 21)
• Support for all SDKMAN candidates (Java, Kotlin, Gradle, etc.)
• Comprehensive command-line interface
• User-friendly display of version information

Prerequisites

• Python 3.6+
• SDKMAN installed and configured
• Bash shell environment

Installation

Clone this repository:

git clone https://github.com/yourusername/sdkman-mcp.git
cd sdkman-mcp

Usage

As a Python Module

from src.sdkman_mcp.sdk_commands import sdk_interactive_install

# Install Java with interactive selection
result = sdk_interactive_install("java")

# Install Java 21.x with filtering
result = sdk_interactive_install("java", "21")

Command Line Interface

The package provides ready-to-use scripts:

General SDK Installer

Install any SDKMAN candidate:

python examples/install_sdk.py java       # Install any Java version
python examples/install_sdk.py java 21    # Install Java 21.x
python examples/install_sdk.py kotlin     # Install Kotlin
python examples/install_sdk.py gradle 8   # Install Gradle 8.x

JDK-specific Installer

python examples/install_jdk.py           # Install any JDK version
python examples/install_jdk.py 21        # Install JDK 21.x

Main CLI

The module can also be run directly:

python -m src.sdkman_mcp.sdk_commands install java --version 21
python -m src.sdkman_mcp.sdk_commands list java
python -m src.sdkman_mcp.sdk_commands current

Using with AI Assistants (MCP Integration)

SDKMAN Interactive CLI can be integrated with AI assistants that support the Model Context Protocol (MCP), allowing you to manage your SDKs directly through conversations with AI.

Integration with Claude Desktop

To use this tool with Claude Desktop, edit the Claude configuration file:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

Add the following configuration:

Using with Other MCP-Compatible AI Assistants

For other AI assistants supporting MCP:

1. Configure the assistant to use this module as an MCP server
2. Provide the path to the module: src.sdkman_mcp.sdk_commands
3. Ensure the environment has access to your SDKMAN installation

Available MCP Commands

When integrated with MCP, you can interact with SDKMAN using natural language:

• “List available Java versions”
• “Install Java 21”
• “Show my currently installed SDKs”
• “Update Gradle to the latest version”
• “Set Java 17 as the default version”

The AI assistant will interpret these commands and use the appropriate SDKMAN functions to execute them.

Example Output

When running the interactive installer, you’ll see a formatted list of available versions:

=========================================================================
Available java versions (filter: '21') - 12 results
=========================================================================
Number Vendor       | Use  | Version    | Dist      | Status      | Identifier
------ ------------ | ---- | ---------- | --------- | ----------- | -------------------------
1      Correto      |      | 21.0.7     | amzn      |             | 21.0.7-amzn
2      Correto      |      | 21.0.6     | amzn      |             | 21.0.6-amzn
3      GraalVM CE   |      | 21.0.2     | graalce   |             | 21.0.2-graalce
4      GraalVM Oracle|     | 21.0.7     | graal     |             | 21.0.7-graal
5      GraalVM Oracle|     | 21.0.6     | graal     |             | 21.0.6-graal
6      Java.net     |      | 21.0.2     | open      |             | 21.0.2-open
7      Liberica     |      | 21.0.7.fx  | librca    |             | 21.0.7.fx-librca
8      Liberica     |      | 21.0.7     | librca    |             | 21.0.7-librca
9      Liberica     |      | 21.0.6.fx  | librca    |             | 21.0.6.fx-librca
10     Liberica     |      | 21.0.6     | librca    |             | 21.0.6-librca

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

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

API Reference

The module provides several functions:

• sdk_interactive_install(candidate, search_version=None): Interactive installation
• parse_sdk_versions(output, search_version=None): Parse SDK version list
• Other standard SDKMAN functions (list, install, current, etc.)

How It Works

The tool provides an enhanced interface for SDKMAN by:

1. Executing SDKMAN commands through the shell
2. Parsing and formatting the output
3. Providing an interactive interface for selection
4. Handling installation with proper confirmation steps

Troubleshooting

Common issues and solutions:

• SDKMAN not found: Ensure SDKMAN is properly installed at ~/.sdkman or set the SDKMAN_DIR environment variable
• Permission denied: Check that SDKMAN scripts have execution permissions
• Command not found: Ensure bash is available on your system (required for running SDKMAN commands)
• MCP integration issues: Check that the AI assistant has proper permissions to execute commands

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

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

Acknowledgements

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