xn-skill-mcp

xn-skill-mcp 会把 packages\ 下的 Markdown 工作流整理为一个可安装的 MCP Server，供 Claude Desktop、Cursor、Windsurf、Cline、Roo Code 等 AI 客户端使用。

它不会自行执行这些工作流。它的作用是把当前 skill 库暴露为 MCP tools、prompts 和 resources，让客户端可以发现工作流、查看说明，并将可直接使用的提示词内容注入对话。

暴露能力

• Tools
  • list_catalog: 列出所有 skills、prompts 或 agents
  • search_catalog: 按关键词搜索名称、描述和 Markdown 正文
  • get_entry: 按 id 查看单个条目
  • prepare_entry: 基于条目和可选用户输入生成可直接使用的提示词载荷
  • reload_catalog: 从磁盘重新加载 Markdown 文件
• Prompts
  • 每个条目都会暴露为一个 MCP prompt，id 例如 skill.skill-selector 或 agent.frontend-skill-router
• Resources
  • xn-skill://catalog/index
  • xn-skill://entry/<entry-id>

条目 id 规则

每个 catalog 条目都会生成一个稳定 id：

• skill.<folder-name>
• prompt.<file-name-without-.prompt.md>
• agent.<file-name-without-.agent.md>

示例：

• skill.build-page-from-brief
• prompt.skill-selector
• agent.frontend-skill-router

本地开发

npm install
npm run build
npm start

用于日常迭代开发：

npm run dev

发布到 npm

npm login
npm publish --access public

发布前请先更新 package.json 中的版本号。

客户端配置

Claude Desktop

将下面配置加入 claude_desktop_config.json：

{
  "mcpServers": {
    "xn-skill": {
      "command": "npx",
      "args": ["-y", "@xianniu/mcp-skills"]
    }
  }
}

Cursor

添加一个运行以下命令的 MCP server 配置：

{
  "command": "npx",
  "args": ["-y", "@xianniu/mcp-skills"]
}

Windsurf / Cline / Roo Code

使用相同命令：

{
  "command": "npx",
  "args": ["-y", "@xianniu/mcp-skills"]
}

如果客户端更适合本地二进制方式，先全局安装：

npm install -g @xianniu/mcp-skills

然后配置：

{
  "command": "xn-skill-mcp",
  "args": []
}

推荐使用方式

1. 先用 search_catalog 传入用户意图。
2. 再用返回的 id 调用 prepare_entry。
3. 将渲染后的内容注入模型对话。

示例调用顺序：

{
  "tool": "search_catalog",
  "arguments": {
    "query": "crud 页面"
  }
}

{
  "tool": "prepare_entry",
  "arguments": {
    "id": "skill.generate-pro-crud-page",
    "input": "生成一个用户管理 CRUD 页面，含筛选、新增、编辑、删除"
  }
}

仓库结构

packages/
  skills/
  prompts/
  agents/
src/
  catalog.ts
  index.ts

说明

• 当 includeReferences 为 true 时，服务会将关联的 Markdown 参考内容内联到输出中。
• 当前实现优先针对 MCP 兼容性和 npm 分发做了优化。