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 - 软件开发工具包管理器
• 本项目的全体贡献者