shadowrootdev/awesome-agent-skills-mcp

VoltAgent Awesome Agent Skills 컬렉션에서 엄선된 100개 이상의 AI 에이전트 기술 (skills)에 대한 액세스를 제공하는 Model Context Protocol (MCP) 서버입니다.

Anthropic, Vercel, Trail of Bits, Hugging Face, Stripe, Expo 및 기타 여러 선도적인 조직의 기술을 사용하여 귀하의 AI 어시스턴트를 전문적인 전문가로 변환하세요.

npx awesome-agent-skills-mcp

그게 전부입니다! MCP 클라이언트 설정에 추가하고 100개 이상의 AI 기술을 사용하기 시작하세요.

특징 (Features)
빠른 시작 (Quick Start)
설치 (Installation)
설정 (Configuration)
사용 가능한 기술 (Available Skills)
MCP 도구 (MCP Tools)
사용 예시 (Usage Examples)
개발 (Development)
API 참조 (API Reference)
문제 해결 (Troubleshooting)
크레딧 (Credits)
라이선스 (License)

100개 이상의 엄선된 기술 (Curated Skills)- Anthropic, Vercel, Trail of Bits, Hugging Face 등을 포함한 최고 기관의 기술에 액세스할 수 있습니다자동 동기화 (Auto-Sync)- VoltAgent 저장소에서 기술을 자동으로 가져오고 업데이트합니다MCP 2024-11-05 준수 (MCP 2024-11-05 Compliant)- 최신 Model Context Protocol 사양과 완벽하게 호환됩니다멀티 클라이언트 지원 (Multi-Client Support)- Claude, GitHub Copilot, OpenCode 및 모든 MCP 호환 클라이언트에서 작동합니다스마트 캐싱 (Smart Caching)- 빠른 시작 시간을 위해 효율적인 JSON 기반 캐싱을 사용합니다타입 안정성 (Type-Safe)- 런타임 검증을 위해 TypeScript 및 Zod로 구축되었습니다제로 설정 (Zero Configuration)- 합리적인 기본값과 함께 즉시 작동합니다

npx awesome-agent-skills-mcp

npm install -g awesome-agent-skills-mcp
awesome-agent-skills-mcp

Node.js>= 20.0.0
npm 또는 yarn

npm install awesome-agent-skills-mcp

git clone https://github.com/shadowrootdev/awesome-agent-skills-mcp.git
cd awesome-agent-skills-mcp
npm install
...

프로젝트의 .vscode/mcp.json을 생성하거나 업데이트하세요:

{
"servers": {
"awesome-agent-skills": {
...

또는 로컬 설치의 경우:

{
"servers": {
"awesome-agent-skills": {
...

중요: 설정을 추가한 후, 변경 사항이 적용되려면 VS Code를 완전히 종료(Cmd+Q / Alt+F4)하고 다시 여세요.

Claude Desktop 설정(~/Library/Application Support/Claude/claude_desktop_config.json, macOS 기준)에 추가하세요:

{
"mcpServers": {
"awesome-agent-skills": {
...

~/.config/opencode/opencode.json에 추가하세요:

{
"mcp": {
"awesome-agent-skills": {
...

변수 (Variable)	기본값 (Default)	설명 (Description)
`SKILLS_REPO_URL`	`https://github.com/VoltAgent/awesome-agent-skills.git`	스킬 저장소 (Skills repository) URL
`SKILLS_CACHE_DIR`	`.cache`	캐시 디렉토리 (Cache directory) 경로
`SKILLS_SYNC_INTERVAL`	`60`	자동 동기화 간격 (분 단위, 0은 비활성화)
`LOG_LEVEL`	`info`	로깅 레벨 (debug, info, warn, error)

이 서버는 주요 조직에서 제공하는 **100개 이상의 스킬 (skills)**에 대한 접근을 제공합니다:

문서 처리, 프레젠테이션 생성, 스프레드시트 조작, PDF 처리, 알고리즘 아트, MCP 구축 등.

스킬 (Skill)	설명 (Description)
`docx`	Word 문서 생성, 편집 및 분석
`pptx`	PowerPoint 프레젠테이션 생성 및 편집
`xlsx`	수식을 사용한 스프레드시트 (Spreadsheet) 조작
`pdf`	PDF 처리 및 양식 채우기
`mcp-builder`	MCP 서버 구축 가이드
`webapp-testing`	Playwright 기반 웹 앱 테스트

React 및 Next.js 베스트 프랙티스 (best practices), 배포 및 성능 최적화.

스킬 (Skill)	설명 (Description)
`react-best-practices`	React 성능 최적화 가이드라인
`next-best-practices`	Next.js 컨벤션 (conventions) 및 패턴
`web-design-guidelines`	UI/UX 준수 여부 검토
`vercel-deploy`	Vercel로 앱 배포

보안 분석, 스마트 컨트랙트 (smart contract) 감사 및 코드 리뷰 도구.

스킬 (Skill)	설명 (Description)
`building-secure-contracts`	스마트 컨트랙트 보안 툴킷
`semgrep-rule-creator`	커스텀 Semgrep 규칙 생성
`property-based-testing`	속성 기반 테스트 (property-based testing) 가이드
`static-analysis`	정적 분석 (static analysis) 도구

ML 모델 학습, 데이터셋 관리 및 Hub 운영.

Skill	Description
`hugging-face-cli`	HF Hub CLI 작업
`hugging-face-datasets`	데이터셋 (Dataset) 생성 및 관리
`hugging-face-model-trainer`	TRL을 이용한 모델 미세 조정 (fine-tuning)
`hugging-face-evaluation`	모델 평가 (evaluation) 워크플로우

코드 리뷰, 커밋 컨벤션(commit conventions) 및 PR 자동화.

Skill	Description
`code-review`	Sentry 엔지니어링 코드 리뷰 관행
`commit`	Conventional commit 메시지
`create-pr`	Sentry 컨벤션을 따르는 PR 생성
`find-bugs`	버그 및 취약점 탐지

Stripe- 결제 연동 베스트 프랙티스
Expo- React Native 앱 개발
n8n- 워크플로우 자동화 패턴
Sanity- CMS 베스트 프랙티스
Neon- Serverless Postgres
Remotion- 프로그래밍 방식의 비디오 생성

서버는 네 가지 MCP 도구를 노출합니다:

선택적 필터링을 포함하여 사용 가능한 모든 기술(skills) 목록을 나열합니다.

// 모든 기술 목록 나열
{ }
// 소스별 필터링
...

특정 기술에 대한 상세 정보를 가져옵니다.

{ "skill_id": "react-best-practices" }

선택적 파라미터를 사용하여 기술을 호출합니다.

{
"skill_id": "docx",
"parameters": {
...

저장소(repository)로부터 기술 새로고침을 수동으로 트리거합니다.

{ }

@workspace react-best-practices 기술을 사용하여 내 React 컴포넌트를 리뷰해줘

@workspace 사용 가능한 모든 보안 관련 기술을 나열해줘

@workspace stripe-best-practices 기술을 가져와서 내 결제(checkout) 코드에 적용해줘

Next.js 개발을 위해 사용 가능한 기술은 무엇인가요?

code-review 기술을 사용하여 내 풀 리퀘스트(pull request)를 분석해줘

git clone https://github.com/shadowrootdev/awesome-agent-skills-mcp.git
cd awesome-agent-skills-mcp
npm install

npm run build

# 모든 테스트 실행
npm test
# watch 모드로 테스트 실행
...

npm run lint
npm run format

awesome-agent-skills-mcp/
├── src/
│ ├── index.ts # 엔트리 포인트 (Entry point)
...

interface Skill {
id: string; // 고유 식별자 (Unique identifier)
name: string; // 표시 이름 (Display name)
...

interface ParameterSchema {
name: string;
type: 'string' | 'number' | 'boolean' | 'object' | 'array';
...

캐시 확인: .cache 디렉토리를 삭제하고 재시작하세요
네트워크 확인: GitHub에 접근 가능한지 확인하세요
로그 확인: 상세 출력을 위해 LOG_LEVEL=debug를 설정하세요

전체 재시작 필요: VS Code를 완전히 종료(Cmd+Q)한 후 다시 여세요
설정 경로 확인: .vscode/mcp.json이 워크스페이스 루트에 있는지 확인하세요
서버 확인: 테스트를 위해 npx awesome-agent-skills-mcp를 수동으로 실행하세요

# 서버를 수동으로 테스트합니다
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | npx awesome-agent-skills-mcp

이 프로젝트는 오픈 소스 커뮤니티의 놀라운 작업물을 기반으로 구축되었습니다:

VoltAgent Awesome Agent Skills - VoltAgent에서 관리하는 AI 에이전트 기술(skills)의 큐레이션 컬렉션입니다. 이 MCP 서버는 해당 리포지토리에서 기술을 가져와 제공하며, 이를 통해 MCP 호환 AI 어시스턴트가 사용할 수 있도록 합니다.

이 컬렉션의 기술들은 다음과 같은 주요 조직들에 의해 기여되었습니다:

Anthropic - 문서 처리 (Document processing), 아트 생성 (art generation), MCP 구축
Vercel - React, Next.js, 배포 (deployment)
Trail of Bits - 보안 분석 (Security analysis), 스마트 컨트랙트 (smart contracts)
Hugging Face - ML 워크플로우 (ML workflows), 모델 학습 (model training)
Sentry - 코드 리뷰 (Code review), 커밋 컨벤션 (commit conventions)
Expo - React Native 개발
Stripe - 결제 통합 (Payment integrations)
그리고 더 많은 기여자들!
Model Context Protocol - 프로토콜 사양 (protocol specification)
@modelcontextprotocol/sdk - 공식 TypeScript SDK
Zod - TypeScript 우선 스키마 검증 (schema validation)
simple-git - Git 작업

기여를 환영합니다! PR을 제출하기 전에 기여 가이드라인(contributing guidelines)을 읽어주세요.

리포지토리를 포크(Fork)하세요
기능 브랜치를 생성하세요 (git checkout -b feature/amazing-feature)
변경 사항을 커밋하세요 (git commit -m 'Add amazing feature')
브랜치에 푸시하세요 (git push origin feature/amazing-feature)
풀 리퀘스트(Pull Request)를 생성하세요

버그 보고, 기능 요청 또는 질문을 위해 우리의 이슈 템플릿(issue templates)을 확인하세요.

대화형 문서(interactive documentation)나 데모를 호스팅하기 위해 GitHub Pages를 활성화할 수 있습니다:

문서 생성 (권장: /docs 폴더 사용):
- 저장소 루트(repository root)에 docs/ 디렉토리를 생성하세요
- index.html 파일을 추가하거나 VitePress 또는 Docusaurus와 같은 정적 사이트 생성기(static site generator)를 사용하세요
- 이렇게 하면 문서가 소스 코드와 분리되어 관리됩니다
GitHub Pages 활성화:
- 저장소의 Settings → Pages로 이동하세요
- Source: Deploy from a branch를 선택하세요
- Branch: main을 선택하고, 폴더는 /docs (권장) 또는 저장소 전체를 배포하는 경우 /를 선택하세요
- 저장(Save) 후 배포될 때까지 기다리세요

이는 다음과 같은 용도로 유용합니다:

대화형 API 문서 (Interactive API documentation)
MCP 서버 기능의 라이브 데모
튜토리얼 워크스루 (Tutorial walkthroughs)
스킬 카탈로그 브라우저

참고: /docs 폴더를 사용하는 것이 문서를 체계적으로 관리하고 소스 코드와 분리할 수 있어 권장됩니다. 저장소 전체를 웹사이트로 배포하려는 경우에만 / (루트)를 사용하세요.

이 프로젝트는 MIT 라이선스(MIT License) 하에 라이선스가 부여됩니다 - 자세한 내용은 LICENSE 파일을 참조하세요.

VoltAgent - AI 에이전트 프레임워크 (AI agent framework)
Awesome Agent Skills - 소스 스킬 컬렉션
MCP Servers - 공식 MCP 서버 구현체

AI 에이전트 커뮤니티를 위해 ❤️를 담아 만들었습니다.

⭐ Awesome Agent Skills 저장소에 Star를 눌러주세요

shadowrootdev/awesome-agent-skills-mcp

요약

핵심 포인트

댓글