内容
# 技能MCP服务器
通过MCP提供技能，实现集中式托管和令牌高效的渐进式披露。
## 为什么选择这个
Agent Skills通常作为存储库中的文件存在（`.claude/skills/`、插件等）。该服务器允许您：
- **集中托管技能**：通过HTTP向任何MCP客户端提供技能，来源可以是本地目录、git仓库或OCI注册表
- **最小化令牌使用**：三层渐进式披露机制按需加载代理所需的内容
- **隔离会话**：每个客户端连接都保持其自身的扩展状态
## 快速开始
```bash
export SKILLS_MCP_PATHS="/path/to/skills"
uv run skills-mcp
```
将任何支持Streamable HTTP MCP的客户端（Claude Code、Claude Desktop、Roo Code、Cline、Continue）连接到 `http://localhost:8080/mcp`。参见 [快速入门](docs/getting-started/quickstart.md) 获取安装选项（包括Docker）和 [连接客户端](docs/getting-started/clients.md) 获取每个客户端的设置指南。
## 代理如何使用技能
相同的技能通过三个互补的MCP接口暴露，因此客户端可以使用其支持的任何机制：**资源** (`skills://` URIs，具有渐进式披露)、**工具** (`list_skills`, `get_skill`, `get_skill_resource`, `validate_skill`) 和 **提示** （每个技能一个，客户端将其转换为斜杠命令）。`list_skills` 工具在其始终加载的描述中嵌入了技能目录，这使得代理在没有被告知的情况下可以拾取服务的技能。
详情参见：[MCP接口参考](docs/reference/mcp-surface.md)、[获取代理使用您的技能](docs/guides/agent-uptake.md) 和 [SEP-2640对齐说明](docs/reference/mcp-surface.md#sep-2640-alignment)。
## 技能来源
一个 `skills.yaml` 文件可以从三种来源拉取技能，任意组合（本地优先于git，然后是OCI，在名称冲突时）：
- **本地文件系统** (`local:`)：扫描目录中的 `SKILL.md`
- **Git仓库** (`git:`)：从 `git://host/owner/repo[@ref][#subdir]` 参考资料中克隆到HTTPS
- **OCI注册表** (`oci:`)：从注册表中拉取技能工件
参见 [技能来源](docs/guides/skill-sources.md) 获取演练和 [配置参考](docs/reference/configuration.md) 获取完整模式。
## 文档
完整文档位于 [stacklok.github.io/skills-mcp](https://stacklok.github.io/skills-mcp) （源代码位于 [docs/](docs/index.md) 下）：
- [快速入门](docs/getting-started/quickstart.md) 和 [客户端设置](docs/getting-started/clients.md)
- [配置参考](docs/reference/configuration.md)
- [架构](docs/explanation/architecture.md)
- [代理如何发现服务的技能](docs/explanation/agent-discovery.md)
## 开发
```bash
git clone https://github.com/stacklok/skills-mcp.git
cd skills-mcp
uv sync --all-extras
uv run pytest
uv run ruff check .
uv run mypy src/
```
## 许可证
专有。 Stacklok, Inc. 版权所有。
## 链接
- [Agent Skills 规范](https://agentskills.io/specification)
- [MCP 规范](https://modelcontextprotocol.io/specification/2025-11-25/basic)
