Awesome Agent Skills MCP Server

Um servidor Model Context Protocol (MCP) que fornece acesso a mais de 100 habilidades de agente de IA selecionadas da coleção VoltAgent Awesome Agent Skills.

GitHub

Experimente este MCPPatrocinado

Documentação

Awesome Agent Skills MCP Server

Um servidor Model Context Protocol (MCP) que fornece acesso a mais de 100 habilidades de agentes de IA selecionadas da coleção VoltAgent Awesome Agent Skills.

Transforme seus assistentes de IA em especialistas com habilidades da Anthropic, Vercel, Trail of Bits, Hugging Face, Stripe, Expo e muitas outras organizações líderes.

🚀 Início Rápido

npx awesome-agent-skills-mcp

É isso! Adicione à configuração do seu cliente MCP e comece a usar mais de 100 habilidades de IA.

Recursos

Mais de 100 habilidades selecionadas - Acesse habilidades de organizações de destaque, incluindo Anthropic, Vercel, Trail of Bits, Hugging Face e outras
Sincronização automática - Busca e atualiza automaticamente as habilidades do repositório VoltAgent
Compatível com MCP 2024-11-05 - Compatibilidade total com a especificação mais recente do Model Context Protocol
Suporte a múltiplos clientes - Funciona com Claude, GitHub Copilot, OpenCode e qualquer cliente compatível com MCP
Cache inteligente - Cache eficiente baseado em JSON para inicialização rápida
Type-safe - Construído com TypeScript e Zod para validação em tempo de execução
Zero configuração - Funciona imediatamente com padrões sensatos

Início Rápido

Usando npx (Recomendado)

npx awesome-agent-skills-mcp

Instalação Global

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

Instalação

Pré-requisitos

Node.js >= 20.0.0
npm ou yarn

Pelo npm

npm install awesome-agent-skills-mcp

Pelo código-fonte

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

Configuração

VS Code / GitHub Copilot

Crie ou atualize .vscode/mcp.json no seu projeto:

{
  "servers": {
    "awesome-agent-skills": {
      "command": "npx",
      "args": ["awesome-agent-skills-mcp"]
    }
  }
}

Ou com uma instalação local:

{
  "servers": {
    "awesome-agent-skills": {
      "command": "node",
      "args": ["/path/to/awesome-agent-skills-mcp/dist/index.js"]
    }
  }
}

Importante: Após adicionar a configuração, saia completamente do VS Code (Cmd+Q / Alt+F4) e reabra-o para que as alterações tenham efeito.

Claude Desktop

Adicione à configuração do seu Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

{
  "mcpServers": {
    "awesome-agent-skills": {
      "command": "npx",
      "args": ["awesome-agent-skills-mcp"]
    }
  }
}

OpenCode

Adicione a ~/.config/opencode/opencode.json:

{
  "mcp": {
    "awesome-agent-skills": {
      "type": "local",
      "command": ["npx", "awesome-agent-skills-mcp"],
      "enabled": true
    }
  }
}

Variáveis de Ambiente

Variável	Padrão	Descrição
`SKILLS_REPO_URL`	`https://github.com/VoltAgent/awesome-agent-skills.git`	URL do repositório de habilidades
`SKILLS_CACHE_DIR`	`.cache`	Caminho do diretório de cache
`SKILLS_SYNC_INTERVAL`	`60`	Intervalo de sincronização automática em minutos (0 para desativar)
`LOG_LEVEL`	`info`	Nível de registro (debug, info, warn, error)

Habilidades Disponíveis

O servidor fornece acesso a mais de 100 habilidades de organizações líderes:

Anthropic

Processamento de documentos, criação de apresentações, manipulação de planilhas, manipulação de PDF, arte algorítmica, criação de MCP e muito mais.

Habilidade	Descrição
`docx`	Crie, edite e analise documentos do Word
`pptx`	Criação e edição de apresentações do PowerPoint
`xlsx`	Manipulação de planilhas com fórmulas
`pdf`	Processamento de PDF e preenchimento de formulários
`mcp-builder`	Guia para criar servidores MCP
`webapp-testing`	Testes de aplicativos web baseados em Playwright

Vercel

Práticas recomendadas de React e Next.js, implantação e otimização de desempenho.

Habilidade	Descrição
`react-best-practices`	Diretrizes de otimização de desempenho do React
`next-best-practices`	Convenções e padrões do Next.js
`web-design-guidelines`	Revisão de conformidade de UI/UX
`vercel-deploy`	Implante aplicativos na Vercel

Trail of Bits

Análise de segurança, auditoria de contratos inteligentes e ferramentas de revisão de código.

Habilidade	Descrição
`building-secure-contracts`	Kit de ferramentas de segurança para contratos inteligentes
`semgrep-rule-creator`	Crie regras personalizadas do Semgrep
`property-based-testing`	Orientação para testes baseados em propriedades
`static-analysis`	Ferramentas de análise estática

Hugging Face

Treinamento de modelos de ML, gerenciamento de conjuntos de dados e operações do Hub.

Habilidade	Descrição
`hugging-face-cli`	Operações de CLI do HF Hub
`hugging-face-datasets`	Criação e gerenciamento de conjuntos de dados
`hugging-face-model-trainer`	Ajuste fino de modelos com TRL
`hugging-face-evaluation`	Fluxos de trabalho de avaliação de modelos

Sentry

Revisão de código, convenções de commit e automação de PR.

Habilidade	Descrição
`code-review`	Práticas de revisão de código da engenharia da Sentry
`commit`	Mensagens de commit convencionais
`create-pr`	Criação de PR seguindo as convenções da Sentry
`find-bugs`	Detecção de bugs e vulnerabilidades

E Muitos Outros...

Stripe - Práticas recomendadas de integração de pagamentos
Expo - Desenvolvimento de aplicativos React Native
n8n - Padrões de automação de fluxos de trabalho
Sanity - Práticas recomendadas de CMS
Neon - Postgres sem servidor
Remotion - Criação de vídeo programática

Ferramentas MCP

O servidor expõe quatro ferramentas MCP:

`list_skills`

Liste todas as habilidades disponíveis com filtragem opcional.

// List all skills
{ }

// Filter by source
{ "source": "repository" }

// Filter by tag
{ "tag": "security" }

`get_skill`

Obtenha informações detalhadas sobre uma habilidade específica.

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

`invoke_skill`

Invoque uma habilidade com parâmetros opcionais.

{
  "skill_id": "docx",
  "parameters": {
    "document_type": "report"
  }
}

`refresh_skills`

Acione manualmente uma atualização das habilidades a partir do repositório.

{ }

Exemplos de Uso

No GitHub Copilot Chat

@workspace Use the react-best-practices skill to review my React components

@workspace List all available security-related skills

@workspace Get the stripe-best-practices skill and apply it to my checkout code

No Claude

What skills are available for Next.js development?

Use the code-review skill to analyze my pull request

Desenvolvimento

Configuração

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

Compilação

npm run build

Executar Testes

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run integration tests only
npm run test:integration

Lint e Formatação

npm run lint
npm run format

Estrutura do Projeto

awesome-agent-skills-mcp/
├── src/
│   ├── index.ts              # Entry point
│   ├── server.ts             # MCP server implementation
│   ├── config.ts             # Configuration management
│   ├── models/
│   │   ├── skill.ts          # Skill type definitions
│   │   ├── parameter.ts      # Parameter schemas
│   │   ├── registry.ts       # SkillRegistry class
│   │   └── repository.ts     # Repository source model
│   ├── services/
│   │   ├── git-sync.ts       # Git repository sync
│   │   ├── skill-parser.ts   # Skill parsing from README
│   │   └── skill-executor.ts # Skill invocation
│   ├── cache/
│   │   └── cache-manager.ts  # JSON-based caching
│   └── utils/
│       └── logger.ts         # Structured logging
├── tests/
│   ├── unit/                 # Unit tests
│   └── integration/          # Integration tests
├── dist/                     # Compiled output
└── .cache/                   # Runtime cache (gitignored)

Referência da API

Objeto de Habilidade

interface Skill {
  id: string;           // Unique identifier
  name: string;         // Display name
  description: string;  // Short description
  source: 'repository' | 'local';
  sourcePath: string;   // GitHub URL or local path
  content: string;      // Full skill content (markdown)
  parameters: ParameterSchema[];
  metadata: {
    author?: string;
    version?: string;
    tags?: string[];
    requirements?: string[];
    sourceOrg?: string;   // GitHub organization
    sourceRepo?: string;  // GitHub repository
  };
  lastUpdated: Date;
}

Esquema de Parâmetros

interface ParameterSchema {
  name: string;
  type: 'string' | 'number' | 'boolean' | 'object' | 'array';
  description: string;
  required: boolean;
  default?: unknown;
  enum?: unknown[];
}

Solução de Problemas

Habilidades Não Carregando

Verifique o cache: Exclua o diretório .cache e reinicie
Verifique a rede: Garanta acesso ao GitHub
Verifique os registros: Defina LOG_LEVEL=debug para saída detalhada

GitHub Copilot Não Vendo Habilidades

Reinicialização completa necessária: Saia completamente do VS Code (Cmd+Q) e reabra
Verifique o caminho da configuração: Garanta que .vscode/mcp.json esteja na raiz do workspace
Verifique o servidor: Execute npx awesome-agent-skills-mcp manualmente para testar

Erros de Conexão

# Test the server manually
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

Créditos

Este projeto é construído sobre o trabalho incrível da comunidade de código aberto:

Fonte de Dados

VoltAgent Awesome Agent Skills - Uma coleção selecionada de habilidades de agentes de IA mantida pela VoltAgent. Este servidor MCP busca e serve habilidades deste repositório, tornando-as acessíveis a assistentes de IA compatíveis com MCP.

Colaboradores de Habilidades

As habilidades desta coleção são contribuídas por organizações líderes, incluindo:

Anthropic - Processamento de documentos, geração de arte, criação de MCP
Vercel - React, Next.js, implantação
Trail of Bits - Análise de segurança, contratos inteligentes
Hugging Face - Fluxos de trabalho de ML, treinamento de modelos
Sentry - Revisão de código, convenções de commit
Expo - Desenvolvimento React Native
Stripe - Integrações de pagamento
E muitos outros colaboradores!

Tecnologias

Model Context Protocol - A especificação do protocolo
@modelcontextprotocol/sdk - SDK oficial em TypeScript
Zod - Validação de esquema TypeScript-first
simple-git - Operações Git

Contribuindo

Contribuições são bem-vindas! Leia nossas diretrizes de contribuição antes de enviar PRs.

Faça um fork do repositório
Crie sua branch de recurso (git checkout -b feature/amazing-feature)
Faça commit das suas alterações (git commit -m 'Add amazing feature')
Envie para a branch (git push origin feature/amazing-feature)
Abra um Pull Request

Veja nossos modelos de issue para relatar bugs, solicitar recursos ou fazer perguntas.

Documentação e Demonstração

GitHub Pages

Você pode habilitar o GitHub Pages para hospedar documentação interativa ou demonstrações:

Crie sua documentação (recomendado: use a pasta /docs):
- Crie um diretório docs/ na raiz do seu repositório
- Adicione um arquivo index.html ou use um gerador de site estático como VitePress ou Docusaurus
- Isso mantém a documentação separada do código-fonte
Habilite o GitHub Pages:
- Vá para Configurações → Pages do seu repositório
- Selecione Fonte: Implantar a partir de uma branch
- Escolha Branch: main e pasta /docs (recomendado) ou / se estiver implantando o repositório inteiro
- Salve e aguarde a implantação

Isso é útil para:

Documentação interativa da API
Demonstrações ao vivo dos recursos do servidor MCP
Tutoriais passo a passo
Navegador do catálogo de habilidades

Nota: Usar a pasta /docs é recomendado, pois mantém a documentação organizada e separada do código-fonte. Use apenas / (raiz) se quiser implantar o repositório inteiro como um site.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Projetos Relacionados

VoltAgent - Framework de agentes de IA
Awesome Agent Skills - A coleção de habilidades de origem
MCP Servers - Implementações oficiais de servidores MCP

Feito com ❤️ para a comunidade de agentes de IA
⭐ Dê uma estrela no repositório Awesome Agent Skills