AI导哈

技能转换工具

Skillhub MCP是一个将Claude风格技能转换为MCP工具的服务，支持多客户端复用和灵活的技能打包。

  • by 214140846
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 214140846/skillhub-mcp

使用说明

Skillhub 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名称：io.github.214140846/killhub-mcp

你已经具备了克劳德风格的技能(SKILL.md)，但在实践中，你经常碰壁：

  • 你的客户说的是MCP，而不是Claude Skills
  • 您的团队使用多个代理（Cursor、Copilot、Codex等），因此跨工具重用技能很痛苦
  • 你需要一种更灵活的方式来组织和传递技能（嵌套文件夹、zip打包）

Skillhub MCP 弥合这一差距：它将克劳德风格的技能转化为MCP工具，因此任何MCP客户端都可以调用相同的技能。

⚠️ 实验。技能可能包含脚本/资源。将它们视为不受信任的，并在可能的情况下使用沙盒/容器运行。

这是MCP服务器还是MCP客户端？

这个项目是一个 MCP服务器.

  • Skillhub MCP（此回购）：作为服务器进程运行，并向客户端公开工具/资源。
  • MCP客户端：Cursor、Claude Code、Codex等编辑/代理。它们启动或连接到MCP服务器。

所得

  • 跨客户端重用：安装一次，从任何MCP客户端使用
  • 灵活包装：嵌套目录， .zip 和 .skill 档案
  • 技能资源：将脚本/数据集/示例作为MCP资源（客户端可以读取的文件）公开
  • 资源回退：a fetch_resource 用于没有本地MCP资源支持的客户端的工具
  • 多次运输： 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"]
  }
}

在流行编辑器（MCP客户端）中安装

下面是主流“vibe编码”编辑器的最小工作示例。

光标

Cursor支持通过以下方式配置MCP服务器 mcp.json。将以下内容添加到您的 全球 ~/.cursor/mcp.json 或项目 .cursor/mcp.json，然后重新启动Cursor。

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

克劳德代码

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

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

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

./.mcp.json

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

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

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

食品法典委员会（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
  • 一 .zip 或 .skill 包含以下内容的存档 SKILL.md （位于存档根目录或 在单个顶级文件夹中）

所有其他文件都成为可下载的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需要一个扁平的技能目录（每个直接的子目录都是一个 技能）。Skillhub MCP更为宽容：

  • 发现嵌套目录
  • .zip / .skill 支持打包技能

如果你需要克劳德代码兼容性，请保持平面布局。

CLI参考

skillhub-mcp [skills_root] [options]

标志/选项 描述
位置 skills_root 可选技能目录（默认为 ~/.skillhub-mcp).
--transport {stdio,http,sse} 传输（默认 stdio).
--host HOST HTTP/SSE传输的绑定地址。
--port PORT HTTP/SSE传输端口。
--path PATH HTTP传输的URL路径。
--list-skills 列出发现的技能并退出。
--verbose 发出调试日志。
--log 将详细日志镜像到 /tmp/skillhub-mcp.log.

安全须知

  • 技能不仅仅是“提示”：它们可以包括脚本和任意文件。
  • Skillhub MCP不运行脚本，但您的客户端可以。更喜欢在沙箱/容器中运行。

语言

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

关于作者

我专注于 AI SaaS走向全球，涵盖了从 想法验证和vibe编码 到 产品开发、基础设施、搜索引擎优化、反向链接和增长实验.

这里分享的一切都来自真实的项目、真实的流量和真实的收入尝试。

相关 MCP