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 （默认），服务器：
- 通过REST API从GitHub获取技能文件
- 适用于 三层扫描限制 使用GitHub树
size（下载前）：
- 最大文件数：每次扫描100个文件 - 最大单个文件大小：每个文件500 KB - 最大总尺寸：所有文件大小为5 MB
- 从接受的文件构建内存中的ZIP存档
- 将ZIP上载到Cisco技能扫描程序API(
/scan-upload)与use_behavioral=true - 通过以下方式自动启动本地扫描服务器
uvx如果没有运行（重复用于后续扫描，退出时关闭）
如果由于扫描限制而排除文件 扫描笔记 包含在显示排除了多少文件和字节的结果中。
如果 uvx 如果未安装，则跳过扫描并发出警告——服务器继续正常工作。
不可信内容通知
从第三方存储库获取的所有技能内容都包括 不可信内容通知内容可以被阅读和显示，但 不能 无需用户明确确认，即可作为指令自动执行或遵循。在采取行动之前，请务必查看内容并扫描结果。
要手动管理扫描仪服务器，请执行以下操作：
# Start it yourself
npm run scanner-api
# Or point to an external instance
SKILL_SCANNER_API_URL=http://your-server:8000AGENTS.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代码审查技巧”
许可证
麻省理工学院