Skillhub MCP

🚀 Skillhub MCP

Skillhub MCP 能够将 Claude 风格的技能转化为 MCP 工具，使得任何 MCP 客户端都可以调用相同的技能，解决了客户端语言不匹配以及技能跨工具复用困难等问题。

📎 链接

• PyPI: https://pypi.org/project/skillhub-mcp/
• PyPI v1.0.1: https://pypi.org/project/skillhub-mcp/1.0.1/
• 技能目录: http://skills.214140846.net/

mcp-name: io.github.214140846/skillhub-mcp

你可能已经拥有 Claude 风格的技能（SKILL.md），但在实际应用中常常会遇到一些问题：

• 你的客户端使用的是 MCP，而不是 Claude Skills。
• 你的团队使用多种代理（如 Cursor、Copilot、Codex 等），因此技能在不同工具之间的复用很麻烦。
• 你希望有一种更灵活的方式来组织和分发技能（如嵌套文件夹、zip 打包）。

⚠️ 重要提示

此项目处于实验阶段。技能可能包含脚本和资源，请将其视为不可信内容，并尽可能在沙箱或容器中运行。

✨ 主要特性

• 跨客户端复用：只需安装一次，即可在任何 MCP 客户端中使用。
• 灵活的打包方式：支持嵌套目录、.zip 和 .skill 存档。
• 技能资源：将脚本、数据集和示例作为 MCP 资源（客户端可以读取的文件）公开。
• 资源回退机制：为不支持原生 MCP 资源的客户端提供 fetch_resource 工具。
• 多种传输方式：支持 stdio（默认）、http 和 sse。

🚀 快速开始

默认的技能根目录为：~/.skillhub-mcp

uvx（推荐）

{
  "skillhub-mcp": {
    "command": "uvx",
    "args": ["skillhub-mcp@latest"]
  }
}

使用自定义技能根目录：

{
  "skillhub-mcp": {
    "command": "uvx",
    "args": ["skillhub-mcp@latest", "/path/to/skills"]
  }
}

📦 安装指南

以下是主流 “氛围编码” 编辑器的最小工作示例。

Cursor

Cursor 支持通过 mcp.json 配置 MCP 服务器。将以下内容添加到全局 ~/.cursor/mcp.json 或项目 .cursor/mcp.json 中，然后重启 Cursor。

{
  "mcpServers": {
    "skillhub-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["skillhub-mcp@latest", "/path/to/skills"]
    }
  }
}

Claude Code

选项 A：通过 Claude Code CLI 进行配置（推荐用于快速设置）：

claude mcp add --transport stdio skillhub-mcp -- uvx skillhub-mcp@latest /path/to/skills

选项 B：通过项目根目录下的 .mcp.json 进行项目范围的配置。你可能需要在 .claude/settings.json 中明确允许项目 MCP 服务器。

./.mcp.json

{
  "mcpServers": {
    "skillhub-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["skillhub-mcp@latest", "/path/to/skills"]
    }
  }
}

./.claude/settings.json（仅批准此服务器）

{
  "enabledMcpjsonServers": ["skillhub-mcp"]
}

Codex (OpenAI)

选项 A：使用 Codex CLI 添加一个 stdio MCP 服务器：

codex mcp add skillhub-mcp -- uvx skillhub-mcp@latest /path/to/skills

选项 B：编辑 ~/.codex/config.toml：

[mcp_servers.skillhub-mcp]
command = "uvx"
args = ["skillhub-mcp@latest", "/path/to/skills"]

💻 使用示例

基础用法

Skillhub MCP 会在根目录（默认 ~/.skillhub-mcp）下发现技能。每个技能可以是：

• 包含 SKILL.md 的目录。
• 包含 SKILL.md 的 .zip 或 .skill 存档（存档根目录或单个顶级文件夹内）。

所有其他文件将成为可供代理读取的可下载 MCP 资源。注意：Skillhub MCP 不会执行脚本，客户端决定是否以及如何运行它们。

示例布局：

~/.skillhub-mcp/
├── summarize-docs/
│   ├── SKILL.md
│   ├── summarize.py
│   └── prompts/example.txt
├── translate.zip
├── analyzer.skill
└── web-search/
    └── SKILL.md

存档规则：

translate.zip
├── SKILL.md
└── helpers/
    └── translate.js

data-cleaner.zip
└── data-cleaner/
    ├── SKILL.md
    └── clean.py

📚 详细文档

目录结构：Skillhub MCP 与 Claude Code 的对比

Claude Code 期望一个扁平的技能目录（每个直接子目录都是一个技能）。而 Skillhub MCP 更加宽松：

• 支持嵌套目录。
• 支持 .zip / .skill 打包的技能。

如果你需要与 Claude Code 兼容，请保持扁平布局。

CLI 参考

skillhub-mcp [skills_root] [options]

安全注意事项

• 技能不仅仅是提示：它们可以包含脚本和任意文件。
• Skillhub MCP 不会运行脚本，但你的客户端可能会。建议在沙箱或容器中运行。

语言支持

• 英文: README.md
• 中文: README.zh-CN.md

👨‍💻 关于作者

作者专注于 AI SaaS 全球化，涵盖了从 创意验证和氛围编码 到 产品开发、基础设施、SEO、反向链接和增长实验 的整个过程。

这里分享的所有内容都来自真实的项目、真实的流量和真实的营收尝试。

• 飞书知识库： Thor 的 AI 全球化内容规划 这是一个结构化的知识库，记录了 AI 产品海外拓展的实践经验，包括需求发现、执行策略和常见陷阱。

• 博客： Thor-AI 博客 公开分享关于构建、发布和迭代 AI 产品的长篇笔记和案例研究。

• 开源项目（高星）： 智慧校园系统

  • GitHub: https://github.com/214140846/TOGO_School_Miniprograme
  • Gitee: https://gitee.com/zengyunengineer/TOGO_School_Miniprograme

• 社交平台： 即刻 分享关于独立开发、AI 工具和产品增长的实时想法。

• 产品：

  • AI 视频生成平台： Sora 2 Sora 2 ai 一个基于 AI 的在线视频生成平台，专注于实际用例和真实用户工作流程。

  • AI 视频与图像生成： AI 视频与图像集合

    模型页面：

    • Grok Video
    • Sora 2
    • Veo 3.1
    • Veo 3
    • Veo 2
    • Kling 2.6
    • Wan 2.5
    • Seedance
    • Nano Banana 2
    • Nano Banana Pro

    这是一个精心策划的 AI 视频和图像生成工具集合，包含实验和能力跟踪。

• AI 视频与图像集合： https://www.notion.so/2e7600937cb3808c818efe79141f7ee6