MCP Skill Hub

MCP运维云端

提供方 srprasanna

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个生产就绪的Model Context Protocol (MCP)服务器,动态加载并暴露来自挂载卷的技能,支持热重载。

一句话选型结论

按资料字段整理

MCP Skill Hub 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 6 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

动态技能加载Python本地部署热重载MCP协议兼容生产就绪Docker支持

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
docker run -i --rm \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Skill Hub当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方srprasanna上游标注的维护方 srprasanna
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

13.0 KB
来自项目仓库与上游目录的原文,未做删改

MCP技能服务器

生产准备就绪 模型上下文协议(MCP) 服务器,通过热重新加载支持从已挂载的卷动态加载和公开技能。

> 📦 可用时间: MCP注册表 -只需一个命令即可安装!

特性

  • 动态技能加载:自动从目录中发现和加载技能
  • 热重新加载:检测SKILL.md文件的更改,并在不重新启动的情况下重新加载
  • 文件夹结构验证:通过明确的错误消息强制实施最佳实践
  • 符合MCP协议:充分落实资源和工具
  • 生产就绪:全面的错误处理、日志记录和验证
  • Docker支持:在容量安装的容器中运行
  • 类型安全:使用Python 3.13功能的完整类型提示
  • 测试良好:>80%的代码覆盖率和全面的测试套件

目录

  • 技能目录结构
  • 快速开始
  • 安装
  • 用法
  • 配置
  • 技能文件格式
  • MCP资源和工具
  • 发展
  • 故障排除
  • 贡献
  • 许可证

技能目录结构

必要条件:每个技能必须在技能目录中的专用文件夹中。服务器将只识别遵循此结构的技能。

✅ 有效结构```

your-skills-directory/
├── skill-one/
│ └── SKILL.md ← Required
├── skill-two/
│ ├── SKILL.md ← Required
│ └── examples/ ← Optional
│ └── example.py
└── skill-three/
├── SKILL.md
├── examples/
│ └── demo.py
└── templates/
└── template.txt


### ❌ 无效结构(将被忽略)```
your-skills-directory/
├── SKILL.md                  ❌ Not in a folder - WILL BE SKIPPED
├── random-file.txt           ❌ Not a skill folder
├── .hidden-folder/           ❌ Hidden folder - WILL BE SKIPPED
│   └── SKILL.md
└── __pycache__/              ❌ System folder - WILL BE SKIPPED
└── SKILL.md

文件夹命名约定

有效文件夹名称:

  • 带连字符的小写字母: my-skill-name
  • 下划线小写: excel_advanced
  • 字母数字: skill-name-v2

无效(将被跳过):

  • 以开头的隐藏文件夹 .
  • 以开头的私人文件夹 _
  • 系统文件夹: __pycache__, node_modules, .git等等。

快速开始

使用Docker(推荐)

  1. 创建技能目录:```bash
    mkdir -p ~/claude-skills/my-first-skill

2. **创建技能档案:**```bash
cat > ~/claude-skills/my-first-skill/SKILL.md << 'EOF'
---
name: "my-first-skill"
description: "My first Claude skill"
---

# My First Skill

This is my first skill for Claude!

## Usage

Simply describe what your skill does here.
EOF
  1. 运行服务器:```bash
    docker run -i --rm \
    -v ~/claude-skills:/skills:ro \
    mcp-skill-hub

### 运用诗歌(发展)

1. **克隆并安装:**```bash
git clone https://github.com/srprasanna/mcp-skill-hub.git
cd mcp-skill-hub
poetry install
  1. 创建技能目录:```bash
    mkdir -p ~/claude-skills/my-first-skill

Create SKILL.md as shown above


3. **运行服务器:**```bash
export MCP_SKILLS_DIR=~/claude-skills
poetry run mcp-skills

安装

先决条件

  • Python 3.13+ (用于发展)
  • 诗歌1.7+ (用于依赖关系管理)
  • 码头工人 (可选,用于容器化部署)

安装诗歌```bash

Clone the repository

git clone https://github.com/srprasanna/mcp-skill-hub.git
cd mcp-skill-hub

Install dependencies

poetry install

Verify installation

poetry run mcp-skills --help


### 构建Docker镜像```bash
# Build the image
docker build -t mcp-skill-hub .

# Or use docker-compose
docker-compose build

用法

本地运行```bash

Set the skills directory

export MCP_SKILLS_DIR=/path/to/your/skills

Run the server

poetry run mcp-skills


### 使用Docker运行```bash
docker run -i --rm \
-v /path/to/your/skills:/skills:ro \
-e MCP_SKILLS_LOG_LEVEL=INFO \
mcp-skill-hub

使用Docker Compose运行```bash

Edit docker-compose.yml to set your skills directory path

docker-compose up mcp-skills


### 与Claude Desktop集成

添加到您的Claude Desktop配置(`claude_desktop_config.json`):```json
{
"mcpServers": {
"skills": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"${HOME}/claude-skills:/skills:ro",
"mcp-skill-hub"
]
}
}
}

或者使用诗歌:```json
{
"mcpServers": {
"skills": {
"command": "poetry",
"args": ["run", "mcp-skills"],
"cwd": "/path/to/mcp-skill-hub",
"env": {
"MCP_SKILLS_DIR": "/path/to/your/skills"
}
}
}
}


**重要提示:** 确保你的 `${HOME}/claude-skills` 目录包含技能文件夹,而不是松散的skill.md文件!

## 配置

配置是通过带有前缀的环境变量完成的 `MCP_SKILLS_`:

|变量|默认值|描述|
|----------|---------|-------------|
| `MCP_SKILLS_DIR` | `/skills` |包含技能文件夹的根目录|
| `MCP_SKILLS_HOT_RELOAD` | `true` |启用自动重新加载|
| `MCP_SKILLS_DEBOUNCE_DELAY` | `0.5` |重新加载前的延迟(秒)|
| `MCP_SKILLS_LOG_LEVEL` | `INFO` |日志级别(调试、信息、警告、错误)|
| `MCP_SKILLS_SCAN_DEPTH` | `1` |扫描深度(始终为1)|

### 示例.env文件```bash
MCP_SKILLS_DIR=/path/to/skills
MCP_SKILLS_HOT_RELOAD=true
MCP_SKILLS_DEBOUNCE_DELAY=0.5
MCP_SKILLS_LOG_LEVEL=INFO

技能文件格式

技能定义见 SKILL.md 带有YAML frontmatter的文件:

最小示例```markdown


name: "my-skill"
description: "Brief description"


My Skill

Your skill content here in Markdown.


### 完整示例```markdown
---
# Required fields
name: "excel-advanced"
description: "Advanced Excel automation techniques"

# Version and authorship
version: "1.2.0"
author: "Your Name"
created: "2025-01-15"
updated: "2025-10-23"

# Dependencies
dependencies:
python: ["openpyxl>=3.0.0", "pandas>=2.0.0"]
system: ["libreoffice"]

# Categorization
category: "office-automation"
tags: ["excel", "spreadsheet", "automation"]
complexity: "intermediate"  # beginner|intermediate|advanced

# Usage guidance
when_to_use:
- "Automating Excel report generation"
- "Processing multiple Excel files"
- "Creating complex formulas programmatically"

# Relationships
related_skills: ["csv-processing", "data-analysis"]

# Examples
has_examples: true
example_files: ["examples/report_generator.py", "templates/report_template.xlsx"]
---

# Excel Advanced Automation

This skill covers advanced Excel automation techniques...

## Features

- Automated report generation
- Formula creation
- Bulk processing

## Examples

See `examples/report_generator.py` for a working example.

可用元数据字段

必修的:

  • name:唯一标识符(建议使用烤肉串大小写)
  • description:简要说明

可选:

  • version:语义版本
  • author:创建者名称
  • created, updated:ISO日期(YYYY-MM-DD)
  • dependencies:Python包或系统工具
  • category:分组的主要类别
  • tags:用于搜索的标签数组
  • complexity:初级、中级或高级
  • when_to_use:使用场景数组
  • related_skills:相关技能名称
  • has_examples:布尔标志
  • example_files:示例文件的路径(相对于技能文件夹)

MCP资源和工具

资源

服务器公开这些MCP资源:

  1. skill://catalog -包含元数据的所有技能的JSON目录
  2. skill://{name} -个人技能评分内容

工具

有四种工具可用于与技能互动:

1. search_skills

按查询、类别、标签或复杂性搜索技能。```json
{
"query": "excel",
"category": "office-automation",
"tag": "automation",
"complexity": "intermediate"
}


#### 2. `reload_skills`

手动触发目录中所有技能的重新加载。```json
{}

3. get_skill_info

在不加载完整内容的情况下获取特定技能的元数据。```json
{
"name": "excel-advanced"
}


#### 4. `list_skill_folders`

列出技能目录中找到的所有有效技能文件夹。```json
{}

发展

设置开发环境```bash

Clone repository

git clone https://github.com/srprasanna/mcp-skill-hub.git
cd mcp-skill-hub

Install dependencies (including dev dependencies)

poetry install

Activate virtual environment

poetry shell


### 运行测试```bash
# Run all tests
poetry run pytest

# Run with coverage
poetry run pytest --cov=mcp_skills --cov-report=html

# Run specific test file
poetry run pytest tests/test_scanner.py

# Run with verbose output
poetry run pytest -v

代码质量```bash

Format code

poetry run black .

Lint code

poetry run ruff check .

Type checking

poetry run mypy src

Run all quality checks

poetry run black . && poetry run ruff check . && poetry run mypy src


### 开发工作流程

1. **创建分支:**```bash
git checkout -b feature/my-feature
  1. 进行更改和测试:```bash
    poetry run pytest
    poetry run mypy src

1. **格式和lint:**```bash
poetry run black .
poetry run ruff check .
  1. 承诺并推动:```bash
    git commit -m "Add feature: description"
    git push origin feature/my-feature

### 项目结构```
mcp-skill-hub/
├── src/mcp_skills/          # Source code
│   ├── models/              # Data models
│   ├── parsers/             # Skill parsers
│   ├── storage/             # Repository pattern
│   ├── scanner.py           # Directory scanning
│   ├── watcher.py           # Hot-reload watcher
│   ├── server.py            # MCP server
│   ├── config.py            # Configuration
│   └── __main__.py          # CLI entry point
├── tests/                   # Test suite
├── examples/                # Example skills
├── docs/                    # Documentation
└── pyproject.toml           # Poetry configuration

故障排除

常见问题

技能未加载

问题: 服务器启动时不会加载任何技能。

解决方案:

  1. 检查你的技能是否在专用文件夹中:```
    /skills/my-skill/SKILL.md ✓
    /skills/SKILL.md ✗
1. 验证文件夹名称是否以开头 `.` 或 `_`
1. 检查日志以获取详细的错误消息

#### 热重载不工作

**问题:** 未检测到对SKILL.md文件的更改。

**解决方案:**

1. 确保 `MCP_SKILLS_HOT_RELOAD=true`
1. 检查文件名称是否准确 `SKILL.md`
1. 验证文件是否在有效的技能文件夹中
1. 在日志中查找文件监视器错误

#### 解析错误

**问题:** SKILL.md文件无法解析。

**解决方案:**

1. 验证YAML frontmatter语法
1. 确保正面位于 `---` 分隔符
1. 检查必填字段(`name`, `description`)存在
1. 使用YAML验证器检查语法

### 验证命令

检查您的技能目录结构:```bash
poetry run mcp-skills --validate

预期产量:```
✓ /skills/excel-advanced: Valid skill
✓ /skills/python-automation: Valid skill
✗ /skills/SKILL.md: Error - Skills must be in folders
✗ /skills/.hidden: Skipped - Hidden folder
⚠ /skills/empty-folder: Warning - No SKILL.md found

Summary: 2 valid, 1 error, 1 warning, 1 skipped


### 日志记录

启用调试日志记录以获取详细信息:```bash
export MCP_SKILLS_LOG_LEVEL=DEBUG
poetry run mcp-skills

日志包括:

  • 文件夹结构验证消息
  • 扫描进度和结果
  • 解析成功与失败
  • 热重载事件
  • 详细的错误上下文

贡献

欢迎投稿!请看 贡献.md 作为指导方针。

快速贡献指南

  1. 分叉存储库
  2. 创建要素分支
  3. 通过测试进行更改
  4. 确保所有测试均已通过,且代码已格式化
  5. 提交拉取请求

代码规范

  • Python 3.13+ 带有类型提示
  • 黑色 用于格式化(88个字符行长度)
  • 拉夫 对于linting
  • 米皮 用于类型检查(严格模式)
  • Pytest 用于测试(覆盖率>80%)

发布

该项目通过GitHub Actions使用自动发布。

创建发布

  1. 首选 行动 → 发布 工作流
  2. 点击 运行工作流
  3. 选择版本凹凸类型:
    - patch -错误修复(0.1.0→0.1.1)
    - minor -新功能(0.1.0→0.2.0)
    - major -重大变化(0.1.0→1.0.0)
    - 或者指定确切的版本(例如。, 1.2.3)
  4. 选择Docker注册表(docker.io 或 ghcr.io)
  5. 点击 运行工作流

工作流程将:

  • ✅ 凹凸版本 pyproject.toml
  • ✅ 创建Git标签和GitHub发布
  • ✅ 构建并推送Docker镜像
  • ✅ 运行测试以验证发布

Docker镜像:

  • Docker Hub: {username}/mcp-skill-hub:{version}
  • github: ghcr.io/{owner}/mcp-skill-hub:{version}

看 发布.md 获取详细的发布文档。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

  • 内置 MCP Python SDK
  • 受克劳德对动态技能管理需求的启发
  • 感谢所有贡献者!

注: 此服务器通过以下方式使人们无法误解文件夹结构要求:

  • 使用文件夹上下文清除错误消息
  • 综合录井
  • 多层次验证
  • 详细文件
  • 工作示例

每个技能都必须在自己的文件夹中。这一设计决策确保了清晰的组织、易于管理和明确的结构。 🎯

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Skill Hub 怎么安装?

在客户端按下面的安装命令接入:docker run -i --rm \。装完在客户端配置里引用同一个包或端点。

MCP Skill Hub 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Skill Hub 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Skill Hub 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Skill Hub 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Skill Hub 能提供哪些能力?

资料显示能力标签包括 Python、Claude、生产就绪。具体工具清单以官方文档为准。

MCP Skill Hub 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

MCP Skill Hub 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。