内容
# 导入技能 Import Skills
MCP 服务器用于导入、管理并使用来自远程 GitHub 仓库的技能(Markdown 文件)。它作为一个 Power 与 Kiro 集成,通过 stdio 传输的 MCP 协议暴露 5 种工具。
## 工具列表
| 工具 | 描述 | 参数 |
|------|-----------|------------|
| `list_remote_skills` | 列出 GitHub 仓库中可用的技能 | `repoUrl`, `token?` |
| `install_skill` | 从仓库安装技能到本地存储 | `repoUrl`, `skillPath?`, `token?` |
| `list_installed_skills` | 列出所有本地安装的技能 | — |
| `get_skill_content` | 返回已安装技能的完整内容 | `skillName` |
| `remove_skill` | 删除已安装的技能 | `skillName` |
## 要求
- [Bun](https://bun.sh) v1.0+
## 安装
```bash
bun install
```
## 使用
```bash
bun run start
```
服务器通过 stdio 启动并等待 MCP 调用。已安装的技能存储在 `~/.kiro/skills/` 中。
## Kiro 配置
在您的 `mcp.json` 中添加:
```json
{
"mcpServers": {
"import-skills": {
"command": "bun",
"args": ["run", "start"],
"cwd": "/path/to/import-skills"
}
}
}
```
## 测试
```bash
# 所有测试(基于属性、单元、集成)
bun test
# 属性测试
bun test tests/properties/
# 单元测试
bun test tests/unit/
# 集成测试
bun test tests/integration/
```
## 项目结构
```
src/
├── index.ts # 入口点 - MCP 服务器设置
├── tools/
│ ├── list-remote.ts # list_remote_skills
│ ├── install.ts # install_skill
│ ├── list-installed.ts # list_installed_skills
│ ├── get-content.ts # get_skill_content
│ └── remove.ts # remove_skill
├── services/
│ ├── github.ts # GitHub API(树和内容)
│ ├── storage.ts # 本地文件系统
│ └── registry.ts # 元数据注册表
├── utils/
│ └── url-parser.ts # GitHub URL 解析器
│ └── name-extractor.ts # 技能名称提取器
└── types/
└── index.ts # 共享类型
```
## 本地存储
```
~/.kiro/skills/
├── registry.json # 已安装技能的元数据
└── owner-repo/ # 按仓库划分的命名空间
└── skill.md
```
## 技术栈
- **运行时**: Bun
- **语言**: TypeScript(ESNext 模块)
- **MCP SDK**: @modelcontextprotocol/sdk
- **验证**: Zod
- **PBT 测试**: fast-check