技能文件搜索服务

一个通过搜索playbooks.com获取完整技能文件内容的MCP服务器,为编码代理提供丰富的上下文资源。

  • by yigitkonur
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 yigitkonur/mcp-skills-as-context

使用说明

mcp技能作为背景

用于搜索的mcp服务器 playbooks.com 并获取完整的技能文件内容。使您的编码代理能够访问数千个结构化技能文件——指令、模板、参考资料——作为任何任务的丰富上下文。不需要api令牌。

它做什么

两个工具:

搜索技巧

按关键字搜索playbooks.com。返回一个包含技能名称、id、星级和描述的紧凑tsv列表。支持按语言、排序顺序和官方状态进行筛选。使用返回的id get-skill-details 以获取实际文件。

参数:

  • query (必填)--搜索关键字
  • limit (可选,1-500,默认50)--最大结果
  • language (可选)--按语言过滤(例如“Python”、“TypeScript”)
  • sort (可选)--排序顺序(例如“星号”)
  • official (可选)--仅筛选官方/验证技能

输出格式: 制表符分隔值(tsv)——每个技能一行,令牌开销最小。

Skills for "playwright" (showing 50 of 3 pages)
id	name	stars	official	description
microsoft/playwright/playwright-cli	Playwright CLI	78.0k	yes	browser automation and testing
...

获取技能详细信息

获取技能ID(in owner/repo/skillId 格式)并获取完整的技能内容——skill.md和所有参考文件。返回每个文件在其自身标题下的连接标记。

运作原理

  • 从结构化html中抓取playbooks.com搜索页面并解析技能卡
  • 直接从详细页面上的next.js rsc流数据中提取SKILL.md内容
  • 从raw.githubusercontent.com获取参考文件(公共存储库,无需令牌)
  • 并行获取所有页面以进行快速多页搜索
  • 可作为http服务器(通过mcp使用框架)和stdio传输(通过 @modelcontextprotocol/sdk)

数据来源: 所有技能数据都来自 playbooks.com 和 raw.githubusercontent.com不需要api令牌。

两次运输

  • 标准 --运行通过 npx mcp-skills-as-context。这是本地代理集成的默认设置。
  • 超文本传输协议 --在可配置端口上运行基于hono的服务器。用于远程部署。

安装

添加到您的mcp配置中:

{
  "mcpServers": {
    "skills-as-context": {
      "command": "npx",
      "args": ["-y", "mcp-skills-as-context"]
    }
  }
}

环境变量

变量 描述
PORT 用于http传输的服务器端口(默认值:3000)

许可证

麻省理工学院