Sdkman MCP

🚀 SDKMANインタラクティブコンソール

SDKMANインタラクティブコンソールは、SDKMAN用の拡張インターフェースツールです。このツールは、ユーザーが様々なSDKをより簡単に閲覧、フィルタリング、インストールできるように設計されています。SDKMANコマンドの実行、出力の解析と整形、およびインタラクティブな選択インターフェースの提供を通じて、ユーザー体験を向上させます。

✨ 主な機能

• インタラクティブなバージョン選択：整形表示付きのバージョン選択機能。
• バージョンリスト解析：SDKバージョンリストを解析し、特定のバージョンを検索できます。
• 標準SDKMAN機能：SDKの一覧表示、SDKのインストール、現在のデフォルトSDKの確認などの機能を備えています。

📦 インストール

前提条件

1. Python 3.6以上をインストールしてください。
2. SDKMANが正しくインストールされ、~/.sdkmanディレクトリに設定されていることを確認するか、環境変数SDKMAN_DIRを設定してください。
3. SDKMANコマンドを実行するために、システムにBashシェルが必要です。

インストール手順

# リポジトリをローカルにクローンする
git clone <repository-url>
cd sdkman-interactive-cli

💻 使用例

基本的な使用法

Pythonモジュールとして使用する場合

# サンプルコード：指定された候補SDKをインストールし、オプションでバージョンを検索する
from sdkman_interactive import sdk_interactive_install

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

コマンドラインインターフェース（CLI）

インストールスクリプトの例：

# スクリプトを通じて任意のSDKMAN候補をインストールする
python3 path/to/install_sdk.py candidate

# JDKの特定バージョンをインストールする
python3 path/to/install_jdk.py --version specific_version

主要なCLIコマンド：

• list：利用可能なすべてのSDKをリストする。
• install <candidate>：指定された候補SDKをインストールする。
• current：現在のデフォルトのSDKを確認する。

高度な使用法

AIアシスタント（MCPプロトコル）との統合

このツールは、MCPプロトコルを介してAIアシスタントと統合し、自動化されたコマンド実行機能を提供します。以下は設定例です。

Claude Desktopでの設定：

1. ユーザーのホームディレクトリにある.config/claude/settings.jsonファイルを開きます。
2. 以下の設定内容を追加します。

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

使用例の出力

以下は、インタラクティブなインストールインターフェースの出力例です。

注意：Use列に>>>が付いているものは現在のデフォルトバージョンです。

バージョン番号を選択してください（または'q'を入力して終了）：

📚 ドキュメント

APIリファレンス

このモジュールは以下の機能関数を提供します。

• sdk_interactive_install(candidate, search_version=None)：SDKをインタラクティブにインストールします。
• parse_sdk_versions(output, search_version=None)：SDKバージョンリストを解析し、フィルタリングします。
• その他の標準SDKMANコマンド関数。

仕組み

このツールは以下の手順で機能を実現します。

1. SDKMANコマンドを実行します。
2. コマンドの出力を解析し、整形します。
3. インタラクティブな選択インターフェースを提供します。
4. インストールの確認手順を処理します。

トラブルシューティング

一般的な問題と解決策は以下の通りです。

• SDKMANが見つからない：SDKMANが~/.sdkmanディレクトリに正しくインストールされていることを確認するか、環境変数SDKMAN_DIRを設定してください。
• 権限が拒否された：SDKMANスクリプトに実行権限があることを確認してください。
• コマンドが見つからない：SDKMANコマンドを実行するために、システムにBashシェルがインストールされていることを確認してください。
• MCP統合の問題：AIアシスタントがコマンドを実行する適切な権限を持っていることを確認してください。

🤝 貢献方法

貢献を歓迎します！自由にPull Requestを送信し、機能を追加したり、問題を修正したりしてください。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルを参照してください。

🙏 謝辞

以下のプロジェクトと貢献者に感謝します。

• SDKMAN - ソフトウェア開発キットマネージャー
• このプロジェクトに貢献してくれたすべての人々