STARWARCLOUD STARWAR.AI
返回市场
本地技能MCP

本地技能MCP

作者：moscaverd2 星标更新：2025-11-17
安装使用来源：spider==github.com

项目介绍

<div align="center">

🎯 Local Skills MCP

使任何LLM或AI代理能够通过MCP利用本地文件系统中的专家技能

npm 版本 ![npm 下载量][npm-downloads-badge] ![npm 类型][npm-types-badge] [![许可证：MIT][license-badge]][license] [![Node][node-badge]][nodejs] [![MCP][mcp-badge]][mcp-protocol]

CI codecov CodeQL

GitHub Stars GitHub Forks GitHub Issues GitHub 最后一次提交 [欢迎 PR][contributing]

快速开始 • 特性 • 用法 • 常见问题 • 贡献

</div>

📑 目录

什么是 Local Skills MCP？

一个通用的模型上下文协议（MCP）服务器，使任何LLM或AI代理能够访问本地文件系统中的专家技能。您的技能成为可移植、可重复使用的提示库，适用于Claude Code、Claude Desktop、Cline、Continue.dev、自定义代理或任何兼容MCP的客户端。

通过结构化的专家级指令来提升AI的能力，用于专门任务。懒加载保留了上下文——仅在初始时加载技能名称和描述；按需加载完整内容。

✨ 特性

  • 🌐 通用 - 适用于任何MCP客户端（Claude Code、Desktop、Cline、Continue.dev、自定义代理）
  • 🔄 可移植 - 编写一次，跨多个AI系统和LLM（Claude、GPT、Gemini、本地模型）使用
  • ⚡ 上下文高效 - 懒加载：仅在初始时加载技能名称/描述（约50个token/技能），按需加载完整内容
  • 🔥 热重载 - 所有更改即时生效（新技能、编辑、删除）无需重启
  • 🎯 多源 - 自动聚合来自包内置技能、~/.claude/skills、./.claude/skills、./skills和自定义路径
  • 📦 零配置 - 开箱即用的标准技能位置
  • ✨ 极简 - 单一工具（get_skill）具有动态技能发现

🚀 快速开始

安装

从npm（推荐）：

npm install -g local-skills-mcp

替代方案：从GitHub：

npm install -g github:kdpa-llc/local-skills-mcp

或者本地克隆：

git clone https://github.com/kdpa-llc/local-skills-mcp.git
cd local-skills-mcp
npm install  # 准备脚本自动构建

需求： Node.js 18+，任何兼容MCP的客户端

配置MCP客户端

添加到您的MCP客户端配置（例如，~/.config/claude-code/mcp.json）：

如果全局安装：

{
  "mcpServers": {
    "local-skills": {
      "command": "local-skills-mcp"
    }
  }
}

如果本地克隆：

{
  "mcpServers": {
    "local-skills": {
      "command": "node",
      "args": ["/绝对路径/to/local-skills-mcp/dist/index.js"]
    }
  }
}

对于Cline： 在VS Code设置中 → "Cline: MCP设置" 同样的配置

对于其他MCP客户端： 根据其MCP服务器设置使用相同的命令/参数结构。

服务器自动聚合来自多个目录的技能，优先顺序如下（从低到高）：

  1. 包内置技能（包括自文档化的使用指南）
  2. ~/.claude/skills/ - 全局技能
  3. ./.claude/skills/ - 项目特定技能
  4. ./skills - 默认项目技能
  5. $SKILLS_DIR - 自定义目录（如果已设置）

后面的目录覆盖前面的目录，允许您自定义内置技能。

创建并使用技能

选项1：请求Claude创建技能（推荐）

安装Local Skills MCP后，您可以请求Claude为您创建技能：

您："创建一个Python专家技能，帮助我编写干净、符合习惯用法的Python代码"
Claude：[在~/.claude/skills/python-expert/SKILL.md中创建适当的内容]
✅ 已创建python-expert技能！由于热重载，它立即可用。

您："制作一个专注于安全性和最佳实践的拉取请求审查技能"
Claude：[创建带有详细PR审查说明的技能]
✅ pr-reviewer技能现在可以立即使用！

Claude将使用内置的skill-creator技能生成结构良好的技能，具有适当的YAML前言、触发关键词和最佳实践。

选项2：手动创建

创建~/.claude/skills/my-skill/SKILL.md：

---
name: my-skill
description: 这个技能做什么以及何时使用它
---

您是[领域]方面的专家。您的任务是[具体任务]。

指导原则：

1. 具体明确
2. 提供示例
3. 有所帮助

使用技能：

在您的AI客户端中请求任何技能："使用my-skill技能"

AI会自动发现可用技能，并按需加载它们。所有更改即时生效，因为有热重载——无需重启！

📝 SKILL.md 格式

每个技能都是一个带有YAML前言的SKILL.md文件：

---
name: 技能名称
description: 简要描述这个技能做什么以及何时使用它
---

您的技能说明以Markdown格式...

必需字段：

  • name - 技能标识符（小写，连字符，最多64个字符）
  • description - 对于技能选择至关重要（最多200个字符）

撰写有效的描述：

模式：[它做什么]。当[触发条件/关键词]时使用。

  • ✅ 好： "根据git diff生成清晰的提交消息。当编写提交消息或审查暂存更改时使用。"
  • ✅ 好： "分析Excel电子表格并创建透视表。当处理.xlsx文件或表格数据时使用。"
  • ❌ 差： "帮助处理Excel文件"

Claude使用语言理解来决定何时调用技能——具体的触发关键词有助于Claude做出更好的决策。

🎯 使用

单一工具： get_skill - 加载特定任务的专家提示指令

工作原理：

  1. AI看到所有可用技能在工具描述中（自动更新）
  2. 当您请求一个技能时，AI调用get_skill
  3. 完整的技能内容加载，带有详细的指令

内置技能： 包含三个自文档化的技能，解释如何使用Local Skills MCP和创建新技能。这些技能在安装后立即可用：

  • local-skills-mcp-usage - 快速使用指南
  • local-skills-mcp-guide - 综合文档
  • skill-creator - 技能创作最佳实践

技能聚合： 自动聚合来自包内置技能、~/.claude/skills/、./.claude/skills/、./skills和$SKILLS_DIR（如果设置）。后面的目录覆盖重复项。

自定义目录： 通过环境变量添加：

{
  "command": "local-skills-mcp",
  "env": {
    "SKILLS_DIR": "/自定义路径/to/skills"
  }
}

示例技能：

---
name: code-reviewer
description: 审查代码的最佳实践、错误和安全性。当审查PR或分析代码质量时使用。
---

您是一位具备软件工程最佳实践专业知识的代码审查员。

分析代码：

1. 正确性和错误
2. 最佳实践
3. 性能和安全性问题
4. 可维护性

提供具体、可行的反馈。

🆚 与内置技能的区别

功能Local Skills MCP内置Claude技能
可移植性任何MCP客户端仅限Claude Code
存储多个目录聚合仅限~/.claude/skills/
调用显式通过MCP工具由Claude自动调用
上下文使用懒加载（仅名称）所有技能都在上下文中

❓ 常见问题

<details> <summary><strong>Q: 支持哪些MCP客户端？</strong></summary> <p>任何兼容MCP的客户端：Claude Code、Claude Desktop、Cline、Continue.dev或自定义代理。</p> </details> <details> <summary><strong>Q: 这与Claude的内置技能有何不同？</strong></summary> <p>适用于任何MCP客户端（而不仅仅是Claude），从多个目录聚合，显式调用控制，以及通过懒加载实现更好的上下文效率。</p> </details> <details> <summary><strong>Q: 我可以使用现有的Claude技能吗？</strong></summary> <p>可以！自动聚合来自`~/.claude/skills/`和其他目录。</p> </details> <details> <summary><strong>Q: 添加技能后需要重启吗？</strong></summary> <p>不需要！支持完全热重载。所有更改（新技能、内容编辑、删除）即时生效，无需重启。技能会在每次工具列表请求时动态发现。</p> </details> <details> <summary><strong>Q: 这会消耗多少上下文？</strong></summary> <p>极少量！仅在初始时加载名称/描述（约50个token/技能）。完整内容按需加载，保留95%以上的上下文。</p> </details> <details> <summary><strong>Q: 可以使用多个技能目录吗？</strong></summary> <p>可以！自动聚合来自包内置技能、`~/.claude/skills/`、`./.claude/skills/`、`./skills`和`$SKILLS_DIR`。</p> </details> <details> <summary><strong>Q: 如果有重复的技能名称怎么办？</strong></summary> <p>后面的目录覆盖前面的目录：包内置 → `~/.claude/skills` → `./.claude/skills` → `./skills` → `$SKILLS_DIR`。这允许您自定义内置技能。</p> </details> <details> <summary><strong>Q: 包含哪些内置技能？</strong></summary> <p>该包包含三个自文档化的技能：`local-skills-mcp-usage`（快速使用指南）、`local-skills-mcp-guide`（综合文档）和`skill-creator`（技能创作指南）。这些技能在安装后立即可用。</p> </details> <details> <summary><strong>Q: 支持本地LLM（Ollama、LM Studio）吗？</strong></summary> <p>支持！适用于任何兼容MCP的LLM设置。技能是结构化的提示，适用于任何模型。</p> </details> <details> <summary><strong>Q: 支持离线使用吗？</strong></summary> <p>支持！完全运行在本地文件系统上（尽管您的LLM可能需要互联网，取决于模型）。</p> </details> <details> <summary><strong>Q: 如何创建一个好的技能？</strong></summary> <p>遵循<a href="#-skillmd格式">SKILL.md格式</a>。使用清晰的描述、触发关键词、具体指令和示例。</p> </details> <details> <summary><strong>Q: 在哪里可以获得帮助？</strong></summary> <p>在GitHub上<a href="https://github.com/kdpa-llc/local-skills-mcp/issues">打开一个问题</a>。</p> </details>

更多： 查看[CONTRIBUTING.md][contributing]、[SECURITY.md][security]、[CHANGELOG.md][changelog]

🤝 贡献

欢迎贡献！请参阅[CONTRIBUTING.md][contributing]获取指南。

快速开始：

  1. 分叉仓库
  2. 创建您的功能分支
  3. 进行更改并测试
  4. 提交并推送
  5. 打开一个Pull Request

注意：此项目遵循[行为准则][code-of-conduct]。

🔗 相关项目

优化您的MCP设置，使用这些相关工具：

[MCP压缩代理][mcp-tool-aggregator]

从多个MCP服务器聚合并压缩工具描述

虽然Local Skills MCP提供了专家提示指令，但[MCP压缩代理][mcp-tool-aggregator]通过智能LLM压缩优化了您的工具描述。

完美组合：

  • Local Skills MCP - 专家技能，懒加载（约50个token/技能）
  • MCP压缩代理 - 压缩工具描述（50-80%的token减少）

一起实现：

  • 🎯 技能和工具的最大上下文效率
  • 🔗 通过一个连接访问多个MCP服务器
  • ⚡ 大规模工作流的最小token消耗
  • 🚀 具有数百种工具的专业AI代理设置

[了解更多关于MCP压缩代理 →][mcp-tool-aggregator]

💖 支持这个项目

如果您觉得Local Skills MCP有用，请考虑支持其开发！

<div align="center">

[![GitHub 赞助者][sponsor-github-badge]][sponsor-github] [![请我一杯咖啡][sponsor-coffee-badge]][sponsor-coffee] [![PayPal][sponsor-paypal-badge]][sponsor-paypal]

</div>

支持方式：

📄 许可证

MIT 许可证 - 详见[LICENSE][license-file]文件。版权所有 © 2025 KDPA

🙏 致谢

使用[模型上下文协议SDK][mcp-sdk]构建 • 受[Claude技能][claude-skills]启发

<div align="center">

⬆ 返回顶部

由KDPA制作 ❤️

</div> <!-- 参考链接 --> <!-- 徽标 - README顶部 -->

://www.npmjs.com/package/local-skills-mcp [npm-downloads-badge]: https://img.shields.io/npm/dm/local-skills-mcp [npm-types-badge]: https://img.shields.io/npm/types/local-skills-mcp [license-badge]: https://img.shields.io/badge/License-MIT-yellow.svg [license]: https://opensource.org/licenses/MIT [node-badge]: https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg [nodejs]: https://nodejs.org/ [mcp-badge]: https://img.shields.io/badge/MCP-Compatible-purple.svg [mcp-protocol]: https://modelcontextprotocol.io/

<!-- CI/CD 徽标 --> <!-- GitHub 徽标 --> <!-- 仓库链接 -->