Sdkman MCP

🚀 SDKMAN交互式控制台

SDKMAN交互式控制台是一款针对SDKMAN的增强界面工具，它能够让用户更轻松地浏览、过滤和安装各类SDK。该工具通过执行SDKMAN命令、解析并格式化输出内容，同时提供交互式选择界面，极大地提升了用户体验。

🚀 快速开始

SDKMAN交互式控制台能有效提升SDK的管理效率。在使用前，你需要满足一定的先决条件并完成安装。

✨ 主要特性

• 交互式版本选择：带有格式化显示的版本选择功能，让版本选择更加直观。
• 版本列表解析：可以解析SDK版本列表，还支持搜索特定版本，方便快速定位所需版本。
• 标准SDKMAN功能：涵盖列出SDK、安装SDK和查看当前默认SDK等常见功能。

📦 安装指南

先决条件

1. 安装Python 3.6或更高版本。
2. 确保SDKMAN已正确安装并配置在~/.sdkman目录，或者设置环境变量SDKMAN_DIR。
3. 系统需提供Bash shell以运行SDKMAN命令。

安装步骤

# 克隆仓库到本地
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助手具备执行命令的适当权限。

📄 许可证

本项目采用MIT许可证，具体内容见LICENSE文件。

致谢

感谢以下项目和贡献者：

• SDKMAN - 软件开发工具包管理器
• 本项目的全体贡献者

贡献指南

欢迎贡献！请随意提交Pull Request，为项目增添功能或修复问题。