适合谁
- 已经在使用 tech-leads-club/agent-skills 技能目录、希望在支持 MCP 的编程助手中直接检索和调用技能的开发者
- 希望以渐进式、按需加载方式获取技能内容而非一次性拉取整个目录的场景
A
59FMRS · C
agent-skills-mcp 是社区项目 tech-leads-club/agent-skills 提供的 MCP 服务器,通过 list_skills、search_skills、read_skill、fetch_skill_files 四个工具以渐进式披露方式暴露其技能目录,方便任意兼容 MCP 的客户端按需检索和加载技能内容,但并非官方协议或厂商维护的服务器,使用前应关注第三方技能的许可证与安全扫描声明的实际适用范围。
agent-skills-mcp 是 tech-leads-club/agent-skills 项目的一部分,该项目是一个面向专业 AI 编程代理的、经过安全校验的技能(Skills)注册中心。此 MCP 服务器以“渐进式披露”的方式将技能目录暴露给支持 MCP 的客户端:先搜索或浏览,再按需读取具体技能内容和引用文件,避免一次性加载全部目录。底层技能目录由 CLI 工具(@tech-leads-club/agent-skills)维护,技能在发布前会经过 Snyk Agent Scan 等静态分析扫描。仓库整体许可证信息为 NOASSERTION,但 README 说明 CLI/引擎代码使用 MIT 许可证,由维护者编写的技能文件使用 CC-BY-4.0 许可证,第三方技能保留各自原始许可证。
工具能力
list_skills
按类别浏览完整的技能目录(仅应在用户明确要求浏览/列出目录时调用)
search_skills
按意图对技能进行模糊搜索,快速定位相关技能
read_skill
加载某个技能的主要说明文档(SKILL.md)
fetch_skill_files
按需获取某个技能的具体引用文件或模板文件
安装接入
在支持 MCP 的客户端(如 Claude Code、Cursor、VS Code 等)的配置文件中添加一个 mcpServers 条目,名称为 agent-skills,command 设为 npx,args 设为 ["-y", "@tech-leads-club/agent-skills-mcp"],保存后重启客户端即可通过 npx 自动下载并运行该 MCP 服务器,无需提前全局安装。
claude_desktop_config.json
{"mcpServers":{"agent-skills":{"command":"npx","args":["-y","@tech-leads-club/agent-skills-mcp"]}}}
选型与风险
不适合谁
- 需要官方/厂商直接维护的 MCP 实现的团队(本项目由社区 Tech Leads Club 维护,非 Anthropic 或其他协议/产品官方项目)
- 需要该服务器自身执行代码、访问文件系统或调用外部云服务的场景(README 未说明此服务器具备此类工具)
所需权限
- 运行 npx 需要网络访问权限,以下载并执行 @tech-leads-club/agent-skills-mcp 包
- 该 MCP 服务器需要访问技能目录数据(通过 CDN 或缓存)以支持列表、搜索和读取功能
风险与副作用
- README 提到公开技能市场中约 13% 的技能存在严重漏洞;虽然本项目声称对技能进行静态分析和扫描,但通过 npx -y 自动执行第三方包本身存在信任第三方发布内容的风险
- 仓库许可证字段为 NOASSERTION,且部分技能来自社区或第三方作者、保留各自原始许可证,在商业或合规场景中使用前需要逐一核实具体技能的许可条款
- 文档未提供工具的具体输入输出参数或错误码参考,集成前需要自行查阅 packages/mcp/README.md 获取完整细节
常见排障
- 若客户端无法启动服务器,确认本地 Node.js 版本 ≥ 22(README 徽章标注该版本要求)
- 若首次运行较慢或需要联网,确认网络可以访问 npm 注册表以完成 npx 的按需下载
- 如遇到与技能目录或缓存相关的问题,可参考 CLI 侧的缓存机制(默认缓存于 ~/.cache/agent-skills/),必要时清除该缓存后重试
- 更详细的客户端配置、错误参考和故障排查请查阅仓库中的 packages/mcp/README.md
使用场景
在编程助手内直接搜索和浏览 Agent Skills 技能目录,而无需切换到终端运行 CLI
按需加载某个技能的详细说明和参考文件,减少一次性注入大量上下文
为 Claude Code、Cursor 等客户端动态扩展特定领域(云架构、浏览器自动化、设计还原、安全评审等)的工作流能力
支持客户端
Claude Code完整支持
Cursor完整支持
VS Code部分支持