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를 눌러주세요