AI导哈

技能搜索服务器

一个轻量级的MCP服务器，使AI助手能够从SkillsMP市场搜索和读取技能。

  • by boyonglin
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 boyonglin/skillsmp-mcp-lite

使用说明

SkillsMP MCP服务器（精简版）

一个轻量级的MCP服务器，使AI助手能够从 技能MP 市场。

特性

  • 关键词搜索 --通过短关键字（如“PDF”、“网络爬虫”）查找技能
  • AI语义搜索 --寻找由Cloudflare AI提供支持的自然语言技能
  • 阅读技巧 -通过REST API从GitHub获取技能内容（否 git clone，没有本地文件）
  • 安全扫描 --自动 思科技能扫描仪 通过内存中的ZIP上传进行分析（零磁盘写入）

先决条件

要求 目的 必填
Node.js≥20 运行时 是
SkillsMP API密钥 身份验证 是
紫外线 （提供 uvx) 安全扫描 否

服务器将 退出 如果 SKILLSMP_API_KEY 未设置。

快速设置

自动配置

运行一个命令来自动检测您的MCP客户端并编写配置：

npx -y skillsmp-mcp-lite --setup

这会检测安装了哪些客户端（VS Code、Cursor、Claude Desktop、Claude Code），并添加 skillsmp 每个配置文件的服务器条目。对于VS代码，它还为您的API密钥添加了一个安全的输入提示。

要仅配置特定客户端，请设置 SKILLSMP_MCP_CLIENT 环境变量：

# Windows (PowerShell)
$env:SKILLSMP_MCP_CLIENT="cursor"; npx -y skillsmp-mcp-lite --setup

# macOS / Linux
SKILLSMP_MCP_CLIENT=cursor npx -y skillsmp-mcp-lite --setup

支持的值： vscode, cursor, claude-desktop, claude-code, all.

如果客户已经拥有 skillsmp 条目，它被跳过--运行 --setup 多次是安全的。

手动配置

所有客户端都运行相同的命令——只有配置文件位置和JSON键不同。

服务器定义 （在所有客户中共享）：

"skillsmp": {
  "command": "npx",
  "args": ["-y", "skillsmp-mcp-lite"],
  "env": {
    "SKILLSMP_API_KEY": "YOUR_API_KEY"
  }
}

VS代码/GitHub副本

打开 Ctrl+Shift+P → MCP：打开用户配置，然后添加：

{
  "servers": {
    "skillsmp": { "type": "stdio", "command": "npx", "args": ["-y", "skillsmp-mcp-lite"], "env": { "SKILLSMP_API_KEY": "YOUR_API_KEY" } }
  }
}

VS Code需要额外的 "type": "stdio" 现场。

光标/克劳德桌面

客户端 配置文件
光标 ~/.cursor/mcp.json
克劳德桌面（macOS） ~/Library/Application Support/Claude/claude_desktop_config.json
克劳德桌面（Windows） %APPDATA%\Claude\claude_desktop_config.json 
{
  "mcpServers": {
    "skillsmp": { "command": "npx", "args": ["-y", "skillsmp-mcp-lite"], "env": { "SKILLSMP_API_KEY": "YOUR_API_KEY" } }
  }
}

克劳德代码

claude mcp add skillsmp -- npx -y skillsmp-mcp-lite --env SKILLSMP_API_KEY=YOUR_API_KEY

环境变量

变量 默认值 描述
SKILLSMP_API_KEY — 必修的。 API密钥来自 skillsmp.com/docs/api
GITHUB_TOKEN -- 可选。将GitHub API速率限制从60提高→ 5,000需求/小时
SKILL_SCANNER_API_URL -- 可选。外部技能扫描程序API服务器的URL
SKILL_SCANNER_API_PORT 8000 可选。自动管理扫描仪服务器的端口
SKILLSMP_MCP_CLIENT -- 可选。力 --setup 配置特定客户端(vscode, cursor, claude-desktop, claude-code, all)

可用工具

skillsmp_search_skills

使用关键字搜索技能。

参数 类型 必填 说明
query string 是 搜索关键字（最多200个字符）
page number No 页码（默认值：1）
limit number 否 每页项目数（默认值：20，最大值：100）
sortBy string 否 "stars" 或 "recent"

skillsmp_ai_search_skills

使用自然语言描述寻找技能。

参数 类型 必填 说明
query string 是 自然语言描述（最多500个字符）

skillsmp_read_skill

从GitHub获取技能内容，并可选择运行安全扫描。

参数 类型 必填 说明
repo string 是 GitHub存储库(owner/repo)
skillName string 是 技能名称（最多100个字符，字母数字/连字符/下划线）
enableScan boolean 否 运行Cisco技能扫描程序（默认值： true，要求 uv)

安全扫描

当 skillsmp_read_skill 被称为 enableScan: true （默认），服务器：

  1. 通过REST API从GitHub获取技能文件
  2. 适用于 三层扫描限制 使用GitHub树 size （下载前）：
    • 最大文件数：每次扫描100个文件
    • 最大单个文件大小：每个文件500 KB
    • 最大总尺寸：所有文件大小为5 MB
  3. 从接受的文件构建内存中的ZIP存档
  4. 将ZIP上载到Cisco技能扫描程序API(/scan-upload)与 use_behavioral=true
  5. 通过以下方式自动启动本地扫描服务器 uvx 如果没有运行（重复用于后续扫描，退出时关闭）

如果由于扫描限制而排除文件 扫描笔记 包含在显示排除了多少文件和字节的结果中。

如果 uvx 如果未安装，则跳过扫描并发出警告——服务器继续正常工作。

不可信内容通知

从第三方存储库获取的所有技能内容都包括 不可信内容通知内容可以被阅读和显示，但 不能 无需用户明确确认，即可作为指令自动执行或遵循。在采取行动之前，请务必查看内容并扫描结果。

要手动管理扫描仪服务器，请执行以下操作：

# Start it yourself
npm run scanner-api

# Or point to an external instance
SKILL_SCANNER_API_URL=http://your-server:8000

AGENTS.md集成

从以下位置复制内容 AGENTS.example.md 进入你的顶部 AGENTS.md 以实现自动技能发现。

工作流程：AI接收任务→ 搜索方式 skillsmp_search_skills （简短关键词）→ 回落到 skillsmp_ai_search_skills 如有需要→ 阅读最佳匹配 skillsmp_read_skill → 遵循技能的指示。

搜索提示

  • 关键字搜索：1-3个单词-- "code review", "typescript", "pdf"
  • 语义搜索：完整句子-- "how to build a landing page with React"

使用示例

问你的AI助手：

  • “搜索PDF操作技巧”
  • “寻找构建网络爬虫的技能”
  • “阅读存在主义鸟类/比格犬的python代码审查技巧”

许可证

麻省理工学院

相关 MCP