gomdd - MCP + SKILL Dual Mode Manager
唯一同时支持 MCP 和 SKILL 的 TUI 管理工具
gomdd 是一个强大的终端用户界面(TUI)工具,用于管理 AI 工具和客户端的技能安装。支持 MCP(Model Context Protocol)和 SKILL.md 两种格式,覆盖 22+ AI 工具。
✨ 核心特性
🎯 双模式支持
- MCP 模式: 管理 JSON 配置文件,支持 5 个 MCP 客户端
- SKILL 模式: 管理 SKILL.md 文件,支持 17+ AI Agents
- 两者都安装: 同时支持 MCP 和 SKILL(推荐)
🖥️ 强大的 TUI 界面
- 美观的终端用户界面
- 多视图切换(全部/Claude/CLI/Cursor/OpenCode/Antigravity/Registry)
- 实时搜索和过滤
- 多选批量安装
- 详细的技能信息展示
📦 多种安装方式
- 从官方注册表安装
- 从 GitHub URL 安装(支持技能预览和选择)
- 从本地路径安装
- 从 SKILL.md 文件安装
🎨 丰富的功能
- 技能预览: 从 GitHub 仓库预览所有技能,选择性安装
- 项目级/全局级安装: 支持项目级和全局级安装路径
- 7 种过滤器: npm/docker/mcpb/remote/已安装/未安装
- 3 种排序方式: 名称/类型/状态
- 全局搜索: 快速查找技能
- 环境变量配置: 安装时配置环境变量
- 配置文件自动备份: 安全的配置管理
- 智能缓存系统: ETag 支持,加速加载
🚀 快速开始
下载预编译版本(推荐)
从 下载适合你系统的版本:
Windows
# 下载 gomdd-windows-amd64.exe
# 双击运行或在命令行中执行
.\gomdd-windows-amd64.exemacOS
# Intel 芯片
chmod +x gomdd-darwin-amd64
./gomdd-darwin-amd64
# Apple Silicon (M1/M2/M3)
chmod +x gomdd-darwin-arm64
./gomdd-darwin-arm64Linux
chmod +x gomdd-linux-amd64
./gomdd-linux-amd64从源码编译
# 克隆仓库
git clone https://github.com/asd8237731/gomdd.git
cd gomdd
# 编译
go build -o gomdd
# 运行
./gomdd基本使用
- 启动 gomdd
./gomdd- 浏览技能
- 使用 ↑/↓ 或 j/k 键浏览技能列表 - 按 Tab 切换不同视图 - 按 / 进行全局搜索
- 安装技能
- 选择技能后按 Enter 或 i - 选择安装模式(MCP/SKILL/Both) - 选择安装范围(Global/Project) - 选择目标客户端(支持多选) - 配置环境变量(可选)
- 从 GitHub 预览并安装
- 按 g 进入 GitHub 安装模式 - 输入 GitHub URL(如 https://github.com/vercel-labs/agent-skills) - 预览仓库中的所有技能 - 使用空格键选择要安装的技能 - 按 Enter 安装选中的技能
📖 详细使用指南
安装模式
MCP 模式
将技能写入客户端的 JSON 配置文件。
支持的客户端:
- Claude Desktop (
~/.config/claude/claude_desktop_config.json) - Claude CLI (
~/.config/claude-cli/config.json) - Cursor (
~/.cursor/config.json) - OpenCode (
~/.opencode/mcp.json) - Antigravity (
~/.antigravity/config.json)
SKILL 模式
创建 SKILL.md 文件到指定目录。
支持的 Agents (17个):
- Windsurf, Zed, Continue, Cline, Roo Code
- Aider, Goose, PearAI, Cursor (SKILL)
- Claude Code, Codex, Amp, Kilo Code
- Gemini CLI, GitHub Copilot, Clawdbot, Droid
两者都安装(推荐)
同时安装到 MCP 配置和 SKILL 文件,最大化兼容性。
安装范围
- 全局级(Global): 安装到所有项目可用的全局配置
- 项目级(Project): 仅在当前项目可用
快捷键
导航
Tab- 切换视图↑/↓或k/j- 上下移动Enter或i- 安装技能q或Ctrl+C- 退出
搜索和过滤
/- 全局搜索f- 切换过滤器s- 切换排序方式c- 清除过滤器
管理
d- 删除技能r- 刷新列表g- GitHub URL 安装(支持技能预览)l- 本地路径安装m- SKILL.md 文件安装C- 清除缓存
多选安装
空格- 选择/取消选择a- 全选/取消全选
🎯 使用示例
示例 1: 从 GitHub 预览并选择性安装
- 按
g进入 GitHub 安装模式 - 输入
https://github.com/vercel-labs/agent-skills - 等待扫描完成,查看所有可用技能
- 使用
↑/↓浏览技能列表 - 使用
空格选择需要的技能(可多选) - 按
a全选所有技能(可选) - 按
Enter开始安装 - 选择安装模式和范围
- 完成安装
示例 2: 批量安装到多个客户端
- 选择技能后按
Enter - 选择 "两者都安装"
- 选择 "全局级"
- 使用
空格选择多个客户端 - 按
Enter确认 - 配置环境变量
- 完成安装
示例 3: 项目级安装
- 在项目目录中启动 gomdd
- 选择技能后按
Enter - 选择 "SKILL 模式"
- 选择 "项目级 (Project)"
- 技能将安装到项目的
.claude/skills/等目录
📁 文件结构
gomdd/
├── main.go # 主程序和状态管理
├── types.go # 数据结构定义
├── providers.go # MCP 配置提供者
├── cache.go # 缓存和注册表管理
├── installer.go # 安装逻辑
├── ui_render.go # UI 渲染
├── agent_detector.go # Agent 检测
├── unified_manager.go # 统一管理器
├── skill_file_manager.go # SKILL 文件管理
├── skill_md_parser.go # SKILL.md 解析
├── skill_discovery.go # 技能发现
├── github_skill_scanner.go # GitHub 技能扫描
├── security_validator.go # 安全验证
├── README.md # 本文档
├── SUPPORTED_AGENTS.md # 支持的 AI Agents 列表
└── FINAL_IMPLEMENTATION_REPORT.md # 实施报告🔧 配置
自定义注册表源
创建 ~/.config/gomdd/sources.json:
{
"registries": [
"https://custom-registry.com/servers"
],
"searchPaths": [
"/path/to/local/skills",
"./my-skills"
]
}SKILL.md 格式
---
name: skill-name
description: Skill description
command: command-to-run
args:
- "arg1"
- "arg2"
env:
KEY: "value"
---
# Skill Name
Skill description and documentation.🎨 特色功能
技能预览和选择性安装
- 从 GitHub 仓库扫描所有 SKILL.md 文件
- 预览技能列表和描述
- 选择性安装需要的技能
- 支持多选批量安装
项目级和全局级安装
- 全局级:安装到
~/.claude/skills/等全局目录 - 项目级:安装到
.claude/skills/等项目目录 - 自动检测并安装到所有已安装的 SKILL agents
智能缓存系统
- ETag 缓存
- Commit Hash 追踪
- 自动缓存管理
- 手动清除缓存(按
C)
安全验证
- 路径遍历攻击检测
- 命令注入检测
- URL 安全验证
多包类型支持
- npm 包
- Docker 镜像
- mcpb 包
- 远程 HTTP 服务器
- GitHub 仓库
- 本地路径
- SKILL.md 文件
📊 支持的工具
MCP 客户端(5个)
- Claude Desktop
- Claude CLI
- Cursor
- OpenCode
- Antigravity
SKILL Agents(17个)
- Windsurf, Zed, Continue, Cline, Roo Code
- Aider, Goose, PearAI, Cursor (SKILL)
- Claude Code, Codex, Amp, Kilo Code
- Gemini CLI, GitHub Copilot, Clawdbot, Droid
总计: 22+ AI 工具和客户端
✨ 核心功能特性
双模式支持
- MCP 模式: 支持 5 个 MCP 客户端的 JSON 配置管理
- SKILL 模式: 支持 17 个 AI Agents 的 SKILL.md 文件管理
- 两者都安装: 同时支持 MCP 和 SKILL,最大化兼容性
技能管理
- 技能预览: 从 GitHub 仓库扫描并预览所有可用技能
- 选择性安装: 支持多选批量安装特定技能
- 项目级/全局级安装: 灵活的安装范围选择
用户体验
- TUI 界面: 美观的终端用户界面
- 多选批量安装: 同时安装到多个客户端
- 7 种过滤器: npm/docker/mcpb/remote/已安装/未安装
- 3 种排序方式: 按名称/类型/状态排序
- 智能缓存系统: ETag 支持,加速加载
🛠️ 开发
构建
go build -o gomdd运行测试
go test ./...📝 版本历史
v0.9.0 (2026-01-19)
- ✨ 添加技能预览功能
- ✨ 添加选择性安装功能
- ✨ 支持从 GitHub 仓库扫描所有技能
- ✨ 支持多选批量安装
- 🎨 优化 UI 交互体验
v0.8.0 (2026-01-19)
- ✨ 添加项目级安装路径支持
- ✨ 扩展 SKILL agents 支持到 17 个
- ✨ 优化安装位置显示
- 🎨 改进 UI 显示
v0.7.0
- ✨ 添加双模式支持(MCP + SKILL)
- ✨ 新增 SKILL.md 文件管理
- ✨ 新增统一管理器
- ✨ 4 步安装流程
- 🎨 美观的模式选择 UI
🤝 贡献
欢迎贡献!请遵循以下步骤:
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
📄 许可证
MIT License
🙏 致谢
感谢以下项目提供的灵感和参考:
- vercel-labs/add-skill - SKILL.md 格式规范
- Model Context Protocol - MCP 协议规范
- Bubble Tea - TUI 框架
📞 支持
- 问题反馈:
- 文档: SUPPORTED_AGENTS.md
- 实施报告: FINAL_IMPLEMENTATION_REPORT.md
享受 gomdd 带来的便捷管理体验!
