MCP 서버·Skill 개발 실습 예시

mkdir -p .claude/skills/commit-helper

cat > .claude/skills/commit-helper/SKILL.md <<'EOF'
---
name: commit-helper
description: 스테이징·작업 트리의 변경을 보고 Conventional Commits 형식의 커밋 메시지 초안을 작성한다. 사용자가 "커밋 메시지 써줘", "commit message" 등을 요청할 때 사용한다.
---

# Commit Helper

아래는 현재 작업 트리의 변경 사항이다.

!`git diff HEAD`

위 diff를 바탕으로 커밋 메시지를 작성한다.

- 첫 줄은 `type(scope): summary` 형식(50자 이내).
- type은 feat / fix / docs / refactor / test / chore 중에서 고른다.
- 본문에는 무엇을, 왜 바꿨는지 1~3개 항목으로 설명한다.
- 추측한 변경 사항은 적지 않는다. diff에 보이는 것만 근거로 삼는다.
EOF

> 지금 변경한 내용으로 커밋 메시지 초안 잡아줘

pip install mcp

# weather_server.py
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("weather")

@mcp.tool()
def get_weather(city: str) -> str:
    """주어진 도시의 현재 날씨를 한 줄로 반환한다.

    Args:
        city: 날씨를 조회할 도시 이름 (예: "Seoul")
    """
    # 실제로는 외부 날씨 API를 호출한다. 여기서는 예시 값.
    return f"{city}: 맑음, 24도, 습도 40%"

if __name__ == "__main__":
    mcp.run(transport="stdio")

npx @modelcontextprotocol/inspector python weather_server.py

claude mcp add weather -- python weather_server.py
claude mcp list
claude mcp get weather

.claude/skills/release-validator/
├── SKILL.md
├── scripts/
│   └── validate.py
└── reference/
    └── rules.md

# scripts/validate.py
import sys, re, pathlib

def main(path: str) -> int:
    text = pathlib.Path(path).read_text(encoding="utf-8")
    errors = []
    if not re.search(r"^## \[\d+\.\d+\.\d+\]", text, re.M):
        errors.append("시맨틱 버전 헤딩(## [x.y.z])이 없습니다.")
    if "TODO" in text:
        errors.append("미완성 표시 'TODO'가 남아 있습니다.")
    if errors:
        print("FAIL")
        for e in errors:
            print(f" - {e}")
        return 1
    print("PASS")
    return 0

if __name__ == "__main__":
    sys.exit(main(sys.argv[1]))

---
name: release-validator
description: CHANGELOG/릴리스 노트가 팀 규칙(시맨틱 버전 헤딩, 미완성 표시 없음)을 지키는지 검증한다. 사용자가 릴리스 노트나 CHANGELOG 검증을 요청할 때 사용한다.
allowed-tools: Bash, Read
---

# Release Validator

릴리스 노트를 검증하려면 아래 스크립트를 실행한다.

```
python scripts/validate.py <파일경로>
```

- 출력이 `PASS`면 통과를 알린다.
- `FAIL`이면 출력된 사유를 그대로 사용자에게 전달한다.
- 규칙의 배경과 예외 처리는 `reference/rules.md`를 읽고 판단한다.

# (마켓플레이스 미등록 시 먼저) /plugin marketplace add anthropics/claude-plugins-official
/plugin install skill-creator@claude-plugins-official
# 이후 skill-creator의 안내에 따라 release-validator에 대한 eval을 실행