Skill MCP Manager

Unified Agent Skills & MCP management for AI coding platforms

English | 中文

---

Overview

Skill MCP Manager is a native macOS app that provides a single control plane for managing Agent Skills and Model Context Protocol (MCP) servers across all major AI coding platforms.

Instead of configuring skills and MCP servers separately for each platform, store them once in a central location and distribute via symlinks — one source of truth, zero duplication.

Supported Platforms

Platform	Skills	MCP	Config Path
Claude Code	✅	✅	~/.claude/
Cursor	✅	✅	~/.cursor/
Codex	✅	✅	~/.codex/
Gemini CLI	—	✅	~/.gemini/
Antigravity	—	✅	~/.antigravity/
Trae	—	✅	~/.trae/
OpenClaw	✅	✅	~/.openclaw/

Features

• Central Skill Store — All skills live in ~/.skill-mcp-mgr/skills/, symlinked to each platform
• MCP Server Management — Register, configure, and distribute MCP servers across platforms
• MCP Market — One-click install from a curated list of preset MCP servers
• Skill Marketplace — Search and install from SkillsMP and skills.sh
• Platform Inspector — Click any platform to see its current skills and MCP configuration
• Migration Wizard — Scan existing platforms, import skills into the central store, audit symlinks
• Multi-language UI — English, 中文, 日本語, Français, Deutsch, Español

Install

Download

Grab the latest .dmg from Releases, open it, and drag to Applications.

First launch on unsigned builds: right-click → Open, or run xattr -cr SkillMCPManager.app

Build from Source

git clone https://github.com/IchenDEV/skill-mcp-mgr.git
cd skill-mcp-mgr

# Development (debug)
swift build && swift run SkillMCPManager

# Production (.app + .dmg)
./scripts/build-app.sh
open dist/SkillMCPManager.app

Requirements: macOS 15+, Swift 6.0+

Architecture

Sources/
├── App/            App entry point, global state (AppState)
├── Models/         Skill, Platform, MCPServer, Registry
├── Core/           Central store, symlink engine, migration, i18n
├── Platforms/      Platform adapters (config read/write per platform)
├── MCP/            MCP presets, config manager, distributor
├── Marketplace/    SkillsMP / skills.sh / GitHub clients
└── Views/          SwiftUI views (sidebar, list+detail, settings)

Design Principles

• Central Store (~/.skill-mcp-mgr/) — Single source of truth for all skills and MCP configs, tracked by registry.json
• Platform Adapters — Each platform implements PlatformAdapter protocol; shared defaults handle skills, per-platform overrides handle MCP format differences
• Symlink Distribution — Skills are symlinked (not copied) to platform directories, enabling instant updates

Data Storage

~/.skill-mcp-mgr/
├── skills/          SKILL.md bundles
├── mcps/            MCP preset & user configs
├── backups/         Migration backups
├── registry.json    Skills & MCP registry
└── config.json      App preferences

Release

Automated (GitHub Actions)

Push a version tag to trigger build + release:

git tag v0.1.0 && git push origin v0.1.0

Optional GitHub Secrets for signing and notarization:

Secret	Purpose
APPLE_CERTIFICATE_P12	Code signing certificate (base64)
APPLE_CERTIFICATE_PASSWORD	Certificate password
APPLE_ID	Apple ID for notarization
APPLE_TEAM_ID	Apple Developer Team ID
APPLE_APP_PASSWORD	App-specific password

Manual

./scripts/build-app.sh                          # .app + .dmg
./scripts/build-app.sh --sign="Developer ID Application"  # with signing
./scripts/build-app.sh --app-only               # .app only

Dependencies

• Yams — YAML parsing for SKILL.md frontmatter

License

MIT

---

Skill MCP Manager

跨 AI 编程平台的 Agent Skills 与 MCP 统一管理工具

概述

Skill MCP Manager 是一款 macOS 原生应用，为所有主流 AI 编程平台提供统一的 Agent Skills 和 MCP (Model Context Protocol) 管理方案。

不再需要在每个平台分别配置 Skills 和 MCP —— 只需在中央仓库维护一份，通过符号链接自动分发到各平台。一处维护，多处生效。

支持的平台

平台	Skills	MCP	配置路径
Claude Code	✅	✅	~/.claude/
Cursor	✅	✅	~/.cursor/
Codex	✅	✅	~/.codex/
Gemini CLI	—	✅	~/.gemini/
Antigravity	—	✅	~/.antigravity/
Trae	—	✅	~/.trae/
OpenClaw	✅	✅	~/.openclaw/

功能

• Skills 集中管理 — 统一存储在 ~/.skill-mcp-mgr/skills/，通过符号链接分发到各平台
• MCP Server 管理 — 注册、编辑 MCP 服务器，一键分发到选定平台
• MCP 市场 — 内置常用 MCP 服务预设，一键安装
• 技能市场 — 从 SkillsMP、skills.sh 搜索和安装社区技能
• 平台详情 — 点击任意平台查看其当前 Skills 和 MCP 配置
• 迁移向导 — 扫描已有平台的 Skills，导入到中央仓库，审计符号链接
• 多语言界面 — 中文、English、日本語、Français、Deutsch、Español

安装

下载安装

从 Releases 下载最新 .dmg，打开后拖入「应用程序」文件夹。

未签名版本首次启动：右键 → 打开，或执行 xattr -cr SkillMCPManager.app

从源码构建

git clone https://github.com/IchenDEV/skill-mcp-mgr.git
cd skill-mcp-mgr

# 开发调试
swift build && swift run SkillMCPManager

# 生产构建（.app + .dmg）
./scripts/build-app.sh
open dist/SkillMCPManager.app

要求： macOS 15+、Swift 6.0+

项目架构

Sources/
├── App/            应用入口与全局状态
├── Models/         数据模型（Skill、Platform、MCPServer、Registry）
├── Core/           核心逻辑（中央存储、符号链接、迁移、国际化）
├── Platforms/      平台适配器（各 AI 平台的配置读写）
├── MCP/            MCP 预设、配置管理、分发
├── Marketplace/    外部市场客户端（SkillsMP / GitHub）
└── Views/          SwiftUI 视图

核心设计

• 中央存储 (~/.skill-mcp-mgr/) — 所有 Skills 和 MCP 配置的唯一数据源，通过 registry.json 追踪
• 平台适配器 — 每个平台实现 PlatformAdapter 协议，共享默认实现处理 Skills，各自覆写处理 MCP 格式差异
• 符号链接分发 — Skills 通过符号链接（非复制）分发到各平台目录，更新即时同步

数据存储

~/.skill-mcp-mgr/
├── skills/          SKILL.md 技能文件
├── mcps/            MCP 预设与用户配置
├── backups/         迁移备份
├── registry.json    Skills & MCP 注册表
└── config.json      应用设置

发布

自动发布（GitHub Actions）

推送版本标签自动触发构建和发布：

git tag v0.1.0 && git push origin v0.1.0

可选的 GitHub Secrets（用于签名和公证）：

Secret	用途
APPLE_CERTIFICATE_P12	代码签名证书（base64）
APPLE_CERTIFICATE_PASSWORD	证书密码
APPLE_ID	公证用 Apple ID
APPLE_TEAM_ID	Apple 开发者团队 ID
APPLE_APP_PASSWORD	应用专用密码

手动构建

./scripts/build-app.sh                          # .app + .dmg
./scripts/build-app.sh --sign="Developer ID Application"  # 带签名
./scripts/build-app.sh --app-only               # 仅 .app

依赖

• Yams — YAML 解析，用于读取 SKILL.md 前言

许可

MIT