AI Skills Hub

MCP文档知识

提供方 LidoxLee · 包名 ai-skills-hub

文档知识 stdio · 本地进程 API Key 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

一个动态加载Markdown技能文件的MCP服务器,使AI助手能够访问团队的编码标准、最佳实践和技能知识库。

一句话选型结论

按资料字段整理

AI Skills Hub 属于文档知识类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude Desktop、Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

AI工具集成TypeScript本地部署技能管理Markdown解析团队协作知识库

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
npx ai-skills-hub sync

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 6 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

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

值得选的地方

  • 资料标注 6 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
AI Skills Hub当前 6 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

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

详细介绍

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

人工智能技能中心

MCP(模型上下文协议)服务器,可动态加载Markdown技能文件,使AI助手能够访问团队的编码标准、最佳实践和技能知识库。

Languages / 语言

  • 英语
  • 繁体中文

项目架构```

ai-skills-hub/
├── src/ # --- MCP Server Core (Librarian) ---
│ ├── index.ts # Auto-scans ~/.ai-skills-hub/skills/*/SKILL.md and converts to MCP Tools
│ ├── cli.ts # CLI tool entry point
│ ├── utils.ts # Helper functions (Markdown parsing, path handling)
│ └── commands/ # CLI command implementations
│ ├── sync.ts # Sync command
│ └── check.ts # Check command
├── dist/ # [Ignore] Compiled JS (actual execution code)
├── package.json # Project dependencies and script definitions
├── tsconfig.json # TypeScript configuration
└── README.md # Team usage manual


## 安装

### 方法1:全局安装(推荐)

全局安装软件包,以便从任何地方使用CLI命令:```bash
npm install -g ai-skills-hub

安装后,您可以同时使用 skillshub 和 ai-skills-hub 命令:```bash

Sync skills library and configure AI tools

skillshub sync

Or use the full command name

ai-skills-hub sync

Add a skill from URL

skillshub add

Check status

skillshub check

List all skills

skillshub list

View help

skillshub help


### 方法2:使用npx(无需安装)

如果您不想全局安装,可以使用npx直接运行命令:```bash
# Sync skills library and configure AI tools
npx ai-skills-hub sync

# Add a skill from URL
npx ai-skills-hub add

# Check status
npx ai-skills-hub check

# List all skills
npx ai-skills-hub list

# View help
npx ai-skills-hub help

方法3:本地开发安装

为了促进或地方发展:

  1. 克隆项目```bash
    git clone
    cd ai-skills-hub

1. **安装依赖项**```bash
npm install
  1. 构建项目```bash
    npm run build

1. **地方发展链接**```bash
npm link

链接后,您可以使用 skillshub 命令,就像它是全局安装的一样。

CLI命令

skillshub sync / skillshub s

同步和更新AI工具配置。此命令将:

  • 编译TypeScript代码(在本地开发模式下)
  • 为支持的AI工具配置MCP设置

注: 技能存储在 ~/.ai-skills-hub/skills/,不在存储库中。使用 skillshub add 从存储库中添加技能。

选项:

  • -f, --force:即使没有更改,也强制重新编译

示例:```bash
skillshub sync
skillshub sync --force


### `skillshub check` / `skillshub c`

检查AI工具安装状态和MCP配置状态。

此命令将:

- 显示当前安装的AI工具
- 显示哪些AI工具配置了MCP路由
- 提供配置状态摘要

**选项:**

- `-v, --verbose`:显示详细信息(版本号、配置文件路径、命令等)

**示例:**```bash
skillshub check
skillshub check --verbose

输出图例:

  • ✓ 绿色标记:已安装/已配置
  • ○ 黄色标记:未安装/未配置

skillshub add / skillshub a

将URL中的技能添加到本地技能库。

此命令将:

  • 下载a SKILL.md 文件来自提供的URL
  • 自动将GitHub blob URL转换为原始URL
  • 从URL路径中提取技能名称
  • 将技能保存到 ~/.ai-skills-hub/skills//

选项:

  • -f, --force:如果现有技能已存在,则覆盖它

示例:```bash

Add a skill from GitHub blob URL

skillshub add https://github.com/user/repo/blob/main/skills/api-design/SKILL.md

Add a skill from raw URL

skillshub add https://raw.githubusercontent.com/user/repo/main/skills/api-design/SKILL.md

Force overwrite existing skill

skillshub add https://github.com/user/repo/blob/main/skills/api-design/SKILL.md --force


**URL格式:**

- GitHub blob URL: `https://github.com/{user}/{repo}/blob/{branch}/path/to/SKILL.md`
- 原始GitHub URL: `https://raw.githubusercontent.com/{user}/{repo}/{branch}/path/to/SKILL.md`
- 该命令会自动将blob URL转换为原始URL

**工作流程:**

1. 命令从URL下载SKILL.md文件
1. 从目录路径中提取技能名称(例如。, `api-design` 从 `.../api-design/SKILL.md`)
1. 创建目录 `~/.ai-skills-hub/skills//`
1. 将文件另存为 `SKILL.md` 在该目录中
1. 跑 `skillshub sync` 更新MCP配置

### `skillshub list` / `skillshub l`

列出所有可用的技能及其描述。

此命令将:

- 扫描所有 `SKILL.md` 文件在 `~/.ai-skills-hub/skills/` 目录
- 显示每个技能的文件名、工具名称和描述
- 提供使用技巧

**选项:**

- `-v, --verbose`:显示详细信息(文件大小、行数、上次修改时间)

**示例:**```bash
skillshub list
skillshub list --verbose

输出内容:

  • 文件名(例如。, api-design.md)
  • 工具名称(例如。, api_design)
  • 描述(从Markdown文件的第一个标题中提取)
  • 详细信息(详细模式):文件大小、行数、修改时间

skillshub help

显示帮助信息。

支持的AI工具

本项目支持以下AI工具的MCP配置:

  • 克劳德桌面版 -Anthropic的Claude桌面应用程序
  • 光标 -AI驱动的代码编辑器
  • OpenAI Codex -OpenAI的代码助手CLI
  • GitHub Copilot命令行界面 -GitHub的AI代码助手
  • Gemini CLI -谷歌的Gemini AI命令行界面工具
  • 克劳德代码CLI -Anthropic的Claude Code命令行工具

每种工具的安装方法

OpenAI Codex命令行界面```bash

npm install -g @openai/codex

Set environment variable

export OPENAI_API_KEY="your-api-key"


#### GitHub Copilot命令行界面```bash
# macOS/Linux (using Homebrew)
brew install copilot-cli

# Or using npm
npm install -g @github/copilot-cli

Gemini CLI```bash

npm install -g @google/gemini-cli

Login or set API key

gemini auth login

Or

export GEMINI_API_KEY="your-api-key"


#### 克劳德代码CLI```bash
npm install -g @anthropic-ai/claude-code
# Set environment variable
export ANTHROPIC_API_KEY="your-api-key"

用法

添加技能

技能存储在本地 ~/.ai-skills-hub/skills/。要添加技能,请执行以下操作:

  1. 手动方法: 在中创建目录 ~/.ai-skills-hub/skills/ (例如。, api-design/)并添加a SKILL.md 里面的文件
  2. 使用CLI: 使用 skillshub add 从Git存储库添加技能
  3. 目录名称将自动转换为工具名称(例如。, api-design/ → api_design)

技能文件格式

技能文件使用标准Markdown格式:```markdown

Skill Title

This is the skill description...

Section

Content...

Subsection

More content...


- 第一个标题将自动用作工具描述
- 支持所有标准Markdown语法(标题、列表、代码块等)

### 从技能执行Shell脚本

**新功能!** 技能现在可以包括AI代理可以运行的可执行shell脚本。

**目录结构:**```
~/.ai-skills-hub/skills/
└── your-skill/
├── SKILL.md
├── scripts/
│   ├── setup.sh
│   └── test.sh
└── resources/

可用工具:

  • execute_skill_script -从技能目录中执行特定脚本

如何在SKILL.md中引导AI执行脚本:```markdown

My Skill

When working with this skill, please:
1. Execute scripts/setup.sh to prepare the environment
2. Run scripts/test.sh to validate the implementation

Available Scripts

setup.sh

Prepares the development environment.
Execute: scripts/setup.sh

test.sh

Validates the implementation.
Execute: scripts/test.sh

...


### 在游标代理中使用MCP技巧

**重要提示:MCP工具仅在Cursor的代理模式下可用!**

1. **配置MCP** (如果尚未配置):```bash
skillshub sync
  1. 重新启动游标 加载新的MCP配置

  2. 启用代理模式:

  • 打开光标聊天面板(Cmd+L 或 Ctrl+L)
  • 切换至 代理 模式(非聊天模式)
  1. 使用技能:
    在代理模式下,用自然语言提问,例如:```
    Please use api_design to help me design a RESTful API
    ``````
    According to go_concurrency standards, help me refactor this code

### MCP服务器的手动测试```bash
# Start the server (using stdio transport)
npm start

服务器将通过标准输入/输出与MCP客户端通信。

核心组件

🏗️ 核心组件

  1. ~/.ai技能中心/技能/*/SKILL.md(技能定义)
    技能存储在每个用户的本地主目录中。每个技能都是一个目录,其中包含 SKILL.md 文件。

优势: 工程师只需要用Markdown写:“当我需要做任务X时,请按照步骤Y,下面的例子……”,人工智能就会理解。

维护: 任何会写Markdown的人都可以添加或修改技能。技能可以单独管理,也可以从共享存储库同步。

  1. src/index.ts(动态加载器)
    此MCP服务器不再包含特定的业务逻辑。它只做两件事:
  • 列出工具(List_tools): 扫描 ~/.ai-skills-hub/skills/ 并将每个技能目录转换为AI的工具名称(例如。, api-design/ → api_design).

  • 传递内容(call_tool): 当AI请求时,读取相应的 SKILL.md 内容来自 ~/.ai-skills-hub/skills/ 并将其作为“背景知识”提供给人工智能。

  1. CLI工具(skillshub)
    此CLI工具有助于管理技能和AI工具配置:
  • 使用 skillshub add 将Git存储库中的技能添加到 ~/.ai-skills-hub/skills/
  • 跑 skillshub sync 编译TypeScript代码并为AI工具配置MCP设置
  • 自动为所有支持的AI工具(Claude Desktop、Cursor、OpenAI Codex、GitHub Copilot、Gemini CLI、Claude Code CLI)配置全局设置

🔄 团队协作工作流

  • 技能库: 团队维护着具有标准化技能定义的技能库(例如在GitHub上)。

  • 添加技能: 团队成员A使用添加技能库 skillshub add,将其克隆到 ~/.ai-skills-hub/skills/.

  • 技能更新: 更新技能库时,团队成员可以更新其本地副本或重新添加技能。

  • AI就绪: 团队成员B打开Cursor或Claude并问:“帮我写一个新的服务逻辑”,AI将积极阅读并采用 ~/.ai-skills-hub/skills/.

🌟 为什么这适用于拥有30个微服务的团队?

  • 无污染: 这30个项目的源代码不需要任何更改。无需放置 .cursorrules 或 .claudeprompt 在每个项目中。

  • 集中式: 标准只有一份。如果你在30个项目中的每个项目中都放一个副本,更新它们将是一场灾难。

  • 跨AI工具: 无论团队成员喜欢Cursor、Claude Desktop、Codex、Copilot、Gemini还是Claude Code CLI,只要他们连接到此MCP,他们都会阅读相同的“团队大脑”。

开发指南

项目脚本

  • npm run build -将TypeScript编译为 dist/ 目录
  • npm start -运行已编译的MCP服务器
  • npm run dev -手表模式编译(用于开发)

发布到npm

如果您希望团队成员能够使用 npx ai-skills-hub 命令,您需要先将包发布到npm。

📖 详细指南: 请参考 NPM_PUBLISH_SOP.md 完整的出版标准操作程序。

快速发布步骤:

  1. 登录到npm```bash
    npm login

1. **验证包名称是否可用**```bash
npm view ai-skills-hub

如果包名称已被占用,则需要修改 name 领域 package.json.

  1. 发布包```bash
    npm publish

**注:** 这 `prepublishOnly` 脚本将自动运行 `npm run build` 以确保在发布之前编译最新代码。

1. **验证发布**```bash
npx ai-skills-hub --version

发布后,团队成员可以使用方法1(npx)安装和使用此工具。

项目结构

  • src/index.ts -MCP服务器主程序,实现 list_tools 和 call_tool 处理器
  • src/cli.ts -CLI工具入口点
  • src/utils.ts -实用功能:目录扫描、文件名转换、文件读取等。
  • src/commands/ -CLI命令实现(同步、检查、添加、列表等)
  • ~/.ai-skills-hub/skills/ -用于存储技能Markdown文件的本地目录(首次使用时创建)

贡献

项目开发:

  1. 分叉项目
  2. 创建要素分支(git checkout -b feature/amazing-feature)
  3. 对MCP服务器或CLI工具进行更改
  4. 提交您的更改(git commit -m 'Add amazing feature')
  5. 推到分支(git push origin feature/amazing-feature)
  6. 打开拉取请求

添加技能:
技能在各自的存储库中单独管理。用户通过以下方式添加技能 skillshub add。要创建新的技能库,请参阅技能库文档。

故障排除

AI工具无法连接到MCP服务器

  • 确认您已跑步 skillshub sync 更新配置
  • 检查配置文件路径是否正确
  • 某些工具可能需要重新启动才能加载新配置
  • 验证配置文件中的MCP服务器路径是否正确
  • 使用 skillshub check 检查配置状态

许可证

MIT许可证

常见问题

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

在客户端按下面的安装命令接入:npx ai-skills-hub sync。对应的包名是 ai-skills-hub。装完在客户端配置里引用同一个包或端点。

AI Skills Hub 怎么在 Claude Desktop、Claude、Cursor 里配置?

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

AI Skills Hub 收费吗?

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

AI Skills Hub 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

AI Skills Hub 支持哪些客户端?

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

AI Skills Hub 能提供哪些能力?

资料显示约 6 个工具;能力标签包括 技能管理、团队协作、TypeScript、Claude、文档处理。具体工具清单以官方文档为准。

AI Skills Hub 需要什么运行环境?

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

AI Skills Hub 是本地还是远程?

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

热门专题

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

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