Sdkman MCP

🚀 SDKMAN交互式控制檯

SDKMAN交互式控制檯是一款針對SDKMAN的增強界面工具，它能讓用戶更便捷地瀏覽、過濾和安裝各類SDK。該工具通過執行SDKMAN命令、解析並格式化輸出，以及提供交互式選擇界面，極大地提升了用戶體驗。

🚀 快速開始

在使用SDKMAN交互式控制檯前，你需要完成一些先決條件的準備工作，之後按照安裝指南進行安裝，即可開啟使用。

✨ 主要特性

• 交互式版本選擇：具備帶格式化顯示的版本選擇功能。
• 版本列表解析：可解析SDK版本列表，還支持搜索特定版本。
• 標準SDKMAN功能：涵蓋列出SDK、安裝SDK和查看當前默認SDK等功能。

📦 安裝指南

# 克隆倉庫到本地
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腳本是否具有執行權限。
• 命令未找到：確認系統中安裝了Bash shell（用於運行SDKMAN命令）。
• MCP集成問題：確保AI助手具備執行命令的適當權限。

貢獻指南

歡迎貢獻！請隨意提交Pull Request，為項目增添功能或修復問題。

🔧 技術細節

先決條件

1. 安裝Python 3.6或更高版本。
2. 確保SDKMAN已正確安裝並配置在~/.sdkman目錄，或者設置環境變量SDKMAN_DIR。
3. 系統需提供Bash shell以運行SDKMAN命令。

📄 許可證

本項目採用MIT許可證，具體內容見LICENSE文件。

致謝

感謝以下項目和貢獻者：

• SDKMAN - 軟件開發工具包管理器
• 本項目的全體貢獻者