Skills Server

MCPAI代理

提供方 ivanenev

AI代理 stdio · 本地进程 Token 社区 / 第三方 ClaudeClineVS Code
查看接入方式

一个提供本地技能库访问和Lazy-MCP桥接功能的协议服务器,用于高效获取跨领域专家知识和工具集成。

一句话选型结论

按资料字段整理

Skills Server 属于AI代理类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude、Cline、VS Code,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 3 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量3暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

技能管理JavaScript本地部署协议服务器工具集成高效令牌自动化流程

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 3 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 3 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cline、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cline 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Skills Server当前 3 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ivanenev上游标注的维护方 ivanenev
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.3 KB
来自项目仓库与上游目录的原文,未做删改

MCP服务器技能

模型上下文协议(MCP)服务器从本地目录提供专门的提示库(技能),并提供 懒惰MCP桥 为了与分层工具系统兼容。为任何兼容MCP的客户端提供跨域专家知识的令牌高效访问。

> 平台兼容性:此服务器已 在Linux上测试和开发,但应在配置正确的macOS和Windows上运行。核心技能功能适用于所有平台,而Lazy MCP Bridge集成需要特定于平台的配置调整。有关特定于平台的详细说明,请参阅 安装.md.

特性

  • 渐进呈现:只有上下文中的技能元数据(约50个令牌/技能),按需加载完整内容
  • 代币高效:工具发现期间令牌使用量减少95%以上
  • 自动发现:从可配置目录自动扫描和加载技能
  • 热重新加载:技能立即更新,无需重新启动服务器
  • 可配置的:环境变量控制技能目录位置
  • 懒惰MCP桥:通过渐进式披露无缝集成懒惰的mcp分层工具(最初只公开了2个导航工具)
  • 通用:适用于任何MCP客户端(Cline和其他CLI工具)
  • 技能验证:强制执行命名约定和内容规则
  • 可执行技能:通过工具编排动态生成指令
  • 动态行为:具有参数支持的上下文感知技能执行
  • 工具编排:技能可以指定和使用可用的工具

安装

有关Windows、macOS和Linux的详细安装说明,请参阅 安装.md.

快速开始

  1. 先决条件:Node.js 18+、npm或yarn。
  2. 全球安装 (推荐):```bash
    npm install -g @skills-server/mcp
这将安装 `skills-server` 全球指挥。
1. **地方发展**:```bash
git clone https://github.com/ivanenev/skills-server.git
cd skills-server
npm install
npm run build

后续步骤

  • 配置环境变量(请参见 配置.md).
  • 设置技能目录(默认 ~/.skills).
  • 与您的MCP客户端(Cline和其他CLI工具)集成。

有关故障排除,请参阅 故障排除.md.

配置

有关详细的配置选项、环境变量和路径自定义,请参阅 配置.md.

快速参考

  • 技能目录:设置 SKILLS_DIR 环境变量(默认值: ~/.skills).
  • 延迟MCP集成:启用 LAZY_MCP_ENABLED=true 并设置 LAZY_MCP_COMMAND 到你懒惰的mcp可执行文件。
  • 缓存持续时间:控制 CACHE_DURATION (默认值:5000毫秒)。

MCP客户端设置

将服务器添加到MCP客户端配置中。MCP客户端示例:```json
{
"mcpServers": {
"skills-server": {
"command": "skills-server",
"env": {
"SKILLS_DIR": "~/.skills",
"LAZY_MCP_ENABLED": "true"
}
}
}
}


对于其他客户(Cline等),请参阅 配置.md.

## 懒惰MCP桥(不需要,但建议)

服务器与 **懒惰的mcp** 通过 VoiceTreeLab 以提供对分层工具系统的访问。此桥实现了传统MCP工具和懒惰MCP的分层架构之间的无缝兼容性。

### 安装懒惰MCP

**先决条件:**

- Python 3.8+
- pip包管理器

**安装:**```bash
# Clone the repository
git clone https://github.com/voicetreelab/lazy-mcp.git
cd lazy-mcp

# Install dependencies
pip install -r requirements.txt

# Make the run script executable
chmod +x run-lazy-mcp.sh

配置:
当惰性mcp在您的系统PATH中可用时,或者当 LAZY_MCP_COMMAND 环境变量指向懒惰的mcp可执行文件。

桥梁特征

启用后,服务器会自动:

  1. 渐进呈现:仅显示两个导航工具(lazy_mcp_get_tools_in_category 和 lazy_mcp_execute_tool)而不是将所有143+个工具压平。
  2. 代币效率:保留懒惰mcp的分层令牌节省(约500个令牌,而完整工具列表为25000多个)。
  3. 无缝集成:不需要对现有的懒惰mcp设置进行更改。
  4. 差错恢复:如果懒惰的mcp不可用,请进行优雅的回退。

桥梁优势

  • 通用访问:所有懒惰的mcp工具都可以通过渐进式导航在任何mcp客户端中使用。
  • 代币节省:分层加载,无需客户端更改。
  • 向后兼容:与希望直接访问工具的MCP客户端配合使用。
  • 保留的层次结构:维护懒人mcp的组织结构。

定制

用户重要提示

此软件包包括一个针对作者环境优化的预配置懒惰mcp设置。 为了获得完整的体验,您需要为自己的设置自定义技能服务器和懒惰的mcp配置。

1.自定义工具类别

技能服务器过滤懒惰的mcp工具,以防止与VS Code扩展内部工具的重复。要自定义包含哪些类别,请执行以下操作:

编辑 src/index.ts (第239-243行):```typescript
const universalCategories = [
'brave-search', 'playwright', 'puppeteer', 'filesystem',
'desktop-commander', 'memory', 'youtube', 'fuse-optimizer',
'brave-search-marketplace', 'playwright-marketplace', 'puppeteer-marketplace', 'whatsapp-mcp'
];


**修改此数组以包含与可用MCP服务器匹配的类别。**

### 2.设置自己的懒惰MCP

您的懒惰mcp配置需要指向您自己的mcp服务器位置:

1. **安装懒惰mcp** 跟随 官方文档
1. **配置您的MCP服务器** 在懒惰的麦当劳 `config.json`
1. **更新服务器路径** 以匹配您的安装位置
1. **重新生成层次结构** 使用lazy mcp的结构生成器

### 3.部署注意事项

- **核心技能功能** 没有懒惰的mcp也能工作。
- **懒惰的mcp集成** 需要您自己的懒惰mcp设置。
- **工具过滤** 防止与VS Code扩展内部工具发生冲突。
- **需要定制** 在您的环境中实现最佳性能。

## 技能格式

每个技能都是一个目录,其中包含 `SKILL.md` 带有YAML frontmatter的文件:```
skill-name/
└── SKILL.md

SKILL.md结构```markdown


name: skill-name
description: Brief description of what this skill does and when to use it
type: static | executable # Optional: defines skill behavior
allowed_tools: [tool1, tool2] # Optional: tools this skill can orchestrate
execution_logic: conditional # Optional: dynamic behavior type
parameters: # Optional: skill parameters
param1: string
param2: object


Skill Title

[Comprehensive skill content with instructions, examples, and best practices]


### 示例技能

**静态技能(传统):**```markdown
---
name: docker-compose-manager
description: Manages Docker Compose services for containerized applications. Use when starting, stopping, or checking status of Docker services.
---

# Docker Compose Manager Skill

You are an expert at managing Docker Compose services...

## Core Operations
- **Start services**: Use `docker-compose up -d`
- **Stop services**: Use `docker-compose down`
- etc.

可执行技能(高级):```markdown

name: debug-agent
description: Dynamic debugging agent that analyzes errors and provides fixes using available tools
type: executable
allowed_tools: [list_directory, read_file, search_files, system-monitoring]
execution_logic: conditional
parameters:
error_type: string
context: object


Debug Agent - Dynamic Problem Solver

You are an expert debugging agent that can analyze problems and provide solutions using available tools...

Dynamic Decision Making

Based on the error type and context, select the appropriate tools and approach:

  • File-related issues: Use file system tools to examine code and configuration
  • System problems: Use monitoring tools to check health and performance
  • Integration errors: Test connectivity and data flow
  • Logic errors: Analyze code and test different scenarios

Always provide clear explanations of your findings and step-by-step solutions.


## 用法

### 使用像Cline这样的VS代码扩展

配置后,技能和懒惰的mcp工具将通过渐进式披露自动可用:```
You: "Search for React component libraries"
Cline: [Uses lazy_mcp_get_tools_in_category to find brave-search category,
then lazy_mcp_execute_tool with tool_path "brave-search.brave_web_search"]

You: "Navigate to example.com and take a screenshot"
Cline: [Uses lazy_mcp_execute_tool with tool_path "playwright.browser_navigate",
then lazy_mcp_execute_tool with tool_path "playwright.browser_take_screenshot"]

You: "Set up PostgreSQL database connection"
Cline: [Loads postgres skill automatically]

与其他MCP客户端

技能和懒惰的mcp工具作为标准的mcp工具出现。 注: 与Claude Code和其他CLI工具的集成尚未经过测试,但应基于MCP协议兼容性。

渐进式披露架构

运作原理

  1. 发现:服务器扫描 SKILLS_DIR 技能目录。
  2. 元数据加载:只读取用于工具发现的YAML frontmatter(名称、描述)。
  3. 工具注册:创建仅包含元数据信息的MCP工具。
  4. 延迟MCP集成:启用后,仅显示两个导航工具(lazy_mcp_get_tools_in_category 和 lazy_mcp_execute_tool)而不是将所有143+个工具压平。
  5. 渐进式加载:仅在浏览类别时加载完整的工具详细信息;仅在实际调用技能时加载完整的技能内容。
  6. 代币效率:在发现过程中,每项技能约50个代币,而完整内容则有1500多个代币;懒惰mcp导航约500个代币,而完整工具列表则超过25000个代币。

经验证的绩效指标

  • JSON响应大小:减少54%(91KB→ 42KB)
  • 代币效率:工具发现期间减少95%以上
  • 延迟MCP代币节省:减少92.1%(7298个代币→ 574 代币)通过以下方式测量 measure-progressive-tokens.js
  • 技能代币储蓄:减少96.5%(12328个代币→ 430 代币)通过以下方式测量 measure-progressive-tokens.js
  • 渐进式披露修复:修复前:约30000个代币,修复后:574个代币,节省:减少98.1%
  • 理论最大值:全工具上市约25000多个代币,而渐进披露约500个代币
  • 工具发现:每项技能约50个令牌(仅元数据)
  • 技能执行:仅在需要时提供完整内容(1500+代币)
  • 内容扩展:发现和执行之间的内容比率为22倍
  • 真实AI验证:渐进式披露适用于技能和懒惰的mcp工具
  • 可执行技能:动态指令生成,节省89.2%的令牌
  • 工具编排:技能可以动态使用可用的MCP工具

缓存

  • 元数据缓存:技能元数据为5秒
  • 完整内容缓存:30秒完成技能内容
  • 热重新加载:无需重新启动服务器即可立即反映更改

发展

项目结构```

skills-server/
├── src/
│ └── index.ts # Main server implementation
├── build/
│ └── index.js # Compiled server
├── package.json
└── README.md


### 添加功能

服务器可以通过以下方式进行扩展:

- 附加技能元数据
- 技能验证
- 自定义技能格式
- 与外部API集成

### 测试```bash
# Build and test
npm run build
npm test

# Run comprehensive test suite
node test_runner.js

# Validate progressive disclosure
node test-progressive-disclosure.js

# Measure token savings
node measure-progressive-tokens.js

渐进式披露验证

服务器包括全面的测试,用于验证:

  • 代币效率:发现令牌减少95%以上
  • 仅元数据发现:在工具列表中仅显示技能名称/描述
  • 完整内容加载:调用工具时完成技能内容
  • 技能验证:正确的命名约定和内容规则
  • 真正的AI集成:已准备好与实际型号一起投入生产使用

api参考

工具

  • 获取技能:返回所请求技能的全部内容
  • 输入: skill_name (字符串)
  • 输出:完成技能标记内容
  • lazy_mcp_get_tools_incategory:浏览懒惰mcp工具层次结构
  • 输入: path (string)-使用点表示法的类别路径(根为空字符串)
  • 输出:JSON结构,在该路径上有子类别和工具
  • lazy_mcpexecute_tool:按层次路径执行懒惰mcp工具
  • 输入: tool_path (字符串), arguments (对象)
  • 输出:工具执行结果

配置选项

  • SKILLS_DIR:包含技能文件夹的目录
  • CACHE_DURATION:技能缓存持续时间(毫秒)(默认值:5000)
  • LAZY_MCP_ENABLED:启用延迟mcp集成(默认值:false)
  • LAZY_MCP_COMMAND:懒惰mcp可执行文件的路径

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用,添加测试
  5. 提交拉取请求

许可证

GPL-3.0许可证-有关详细信息,请参阅许可证文件。

相关项目

  • MCP协议 -模型上下文协议规范

内置于 模型上下文协议SDK

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Skills Server 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

Skills Server 怎么在 Claude、Cline、VS Code 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Skills Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Skills Server 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Skills Server 支持哪些客户端?

资料标注支持 Claude、Cline、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Skills Server 能提供哪些能力?

资料显示约 3 个工具;能力标签包括 技能管理、JavaScript、Claude。具体工具清单以官方文档为准。

Skills Server 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Skills Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。