AI导哈

模型上下文协议服务器

一个简洁的MCP服务器，将Claude兼容技能作为工具暴露，使任何具有MCP客户端的代理能够使用它们。

  • by portertech
  • Go
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 portertech/skills-mcp-server

使用说明

MCP服务器技能

一个严肃的MCP（模型上下文协议）服务器，它将与Claude兼容的技能作为工具公开，使任何具有MCP客户端的代理都能使用它们。极简设计，用Go编写。

安装

预构建的二进制文件可在 GitHub发布 页面。

去安装

go install github.com/portertech/skills-mcp-server/cmd/skills@latest

从源代码构建

git clone https://github.com/portertech/skills-mcp-server.git
cd skills-mcp-server
go build -o skills ./cmd/skills

码头工人

docker pull portertech/skills-mcp-server:latest

或者在本地构建：

docker build -t skills-mcp-server:latest .

用法

# Start the server with default skills directory (~/.skills)
skills

# Start with a custom skills directory
skills /path/to/skills

# List discovered skills
skills --list /path/to/skills

# Enable verbose logging
skills --verbose /path/to/skills

码头工人

# Run with skills directory mounted
docker run -i --mount type=bind,src=$HOME/.skills,dst=/skills,readonly skills-mcp-server:latest /skills

# List skills
docker run --mount type=bind,src=$HOME/.skills,dst=/skills,readonly skills-mcp-server:latest --list /skills

MCP客户端配置

克劳德代码/光标等。

添加到MCP配置中：

{
  "mcpServers": {
    "skills": {
      "command": "skills",
      "args": ["/path/to/your/skills"]
    }
  }
}

码头工人

{
  "mcpServers": {
    "skills": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--mount", "type=bind,src=/path/to/skills,dst=/skills,readonly", "skills-mcp-server:latest", "/skills"]
    }
  }
}

创造技能

技能是包含以下内容的目录 SKILL.md 带有YAML frontmatter的文件：

~/.skills/
├── code-review/
│   └── SKILL.md
└── git-workflow/
    └── SKILL.md

SKILL.md格式

---
name: my-skill
description: A brief description of what this skill does
---

# My Skill

Detailed instructions for the AI to follow when using this skill.

## Guidelines

- Specific rules and best practices
- Step-by-step procedures
- Examples and templates

必填字段

  • name：唯一技能标识符
  • description：工具列表中显示的简要说明

运作原理

  1. 发现：服务器扫描技能目录以查找 SKILL.md 文件
  2. 注册：每个技能都成为以该技能命名的MCP工具
  3. 调用：当模型调用工具时，它会收到技能的指令
  4. 执行：模型按照说明完成任务

工具命名

技能名称转换为有效的MCP工具名称：

技能名称 工具名称
code-review code_review
My Skill my_skill
git-workflow git_workflow

转换：

  • 降低名称
  • 将空格和连字符替换为下划线

备注：产生相同工具名称的技能（例如。， code-review 和 code_review)被视为重复。发现的第一个已登记；跳过后续碰撞并发出警告。

示例互动

用户：“查看我的pull请求”

模型: 援引 code_review 工具

服务器返回:

# Skill: code-review

**Description:** Expert code review guidance...

---

When reviewing code, follow these guidelines...

模型：使用说明进行彻底的代码审查。

发展

# Run tests
make test

# Run tests with coverage
make test-cover

# Build
make build

# Format code
make fmt

# Run all checks
make ci

# Test with sample skills
make list-test

看 Makefile 对于所有可用的目标。

发布过程

# Check current version
make version

# Run all checks before release
make ci

# Create a release (runs ci, tags, and pushes to Docker Hub)
make release VERSION=1.0.0

这 release 目标：

  1. 跑动 make ci （皮棉+测试）
  2. 创建带注释的git标签 v<VERSION>
  3. 构建多拱形Docker镜像并将其推送到Docker Hub

要手动释放：

# Create and push tag
make tag-version VERSION=1.0.0
git push origin v1.0.0

# Build and push Docker images
make docker-login  # requires DOCKER_USERNAME and DOCKER_PASSWORD
make docker-publish VERSION=1.0.0

许可证

麻省理工学院

相关 MCP