WordPress Docs

Acesse a documentação do WordPress e ferramentas de desenvolvimento.

Documentação

Servidor MCP WordPress Docs

npm version License: MIT

Um servidor Model Context Protocol (MCP) que fornece documentação do WordPress e ferramentas de desenvolvimento para Claude Code e Claude Desktop. Tenha acesso instantâneo à documentação do WordPress.org, guias do WordPress VIP e referências de funções diretamente nas suas conversas com o Claude.

🚀 Início Rápido

Instalar via npm (Recomendado)

npm install -g wordpress-docs-claude-mcp

Configurar para Claude Code

Adicione ao seu arquivo de configuração MCP do Claude Code (~/.claude/mcp.json):

{
  "mcpServers": {
    "wordpress-docs": {
      "command": "wordpress-docs-mcp"
    }
  }
}

Configurar para Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop:

  • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "wordpress-docs": {
      "command": "wordpress-docs-mcp"
    }
  }
}

Reiniciar o Claude

Reinicie o Claude Code ou o Claude Desktop para carregar o servidor MCP.

🛠️ Ferramentas Disponíveis

hello_wp

Ferramenta de saudação com tema WordPress para testar a conectividade do servidor MCP.

  • Parâmetros: name (obrigatório) - Nome para saudar com contexto WordPress

wp_search_docs

Pesquise a documentação para desenvolvedores do WordPress.org com opções de filtro.

  • Parâmetros:
    • query (obrigatório) - Termo de busca para documentação do WordPress
    • type (opcional) - Tipo de conteúdo: "posts", "functions", "hooks", "classes"

wp_vip_search

Pesquise a documentação da plataforma WordPress VIP para recursos empresariais.

  • Parâmetros:
    • query (obrigatório) - Termo de busca para documentação do WordPress VIP
    • section (opcional) - Seção VIP: "all", "getting-started", "infrastructure", "development", "content"

wp_function_lookup

Obtenha informações detalhadas sobre funções, hooks ou classes específicas do WordPress.

  • Parâmetros:
    • function_name (obrigatório) - Nome exato da função, hook ou classe do WordPress

💡 Exemplos de Uso

Após a configuração, você pode pedir ao Claude para usar essas ferramentas naturalmente:

Pesquisa de Documentação:

  • "Pesquise na documentação do WordPress por custom post types"
  • "Encontre documentação do WordPress VIP sobre caching"
  • "Consulte informações sobre endpoints da REST API"

Consulta de Funções:

  • "Consulte a função wp_enqueue_script"
  • "Encontre documentação para get_post"
  • "Quais parâmetros o add_action aceita?"

Consultas Específicas do VIP:

  • "Pesquise na documentação do VIP por melhores práticas de deployment"
  • "Encontre informações do VIP sobre otimização de performance"
  • "Consulte controles de segurança do VIP"

🔧 Configuração de Desenvolvimento

Se você quiser contribuir ou executar a partir do código-fonte:

  1. Clone o repositório:

    git clone https://github.com/freibergergarcia/wordpress-docs-claude-mcp.git
    cd wordpress-docs-claude-mcp
    
  2. Instale as dependências:

    npm install
    
  3. Compile o projeto:

    npm run build
    
  4. Configure o Claude com o caminho local:

    {
      "mcpServers": {
        "wordpress-docs": {
          "command": "node",
          "args": ["dist/index.js"],
          "cwd": "/absolute/path/to/wordpress-docs-claude-mcp"
        }
      }
    }
    

🧪 Testes

Teste o servidor manualmente (requer jq para saída formatada):

# List available tools
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | wordpress-docs-mcp | jq

# Test WordPress greeting
echo '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "hello_wp", "arguments": {"name": "Developer"}}}' | wordpress-docs-mcp | jq

# Search WordPress documentation
echo '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "wp_search_docs", "arguments": {"query": "REST API", "type": "posts"}}}' | wordpress-docs-mcp | jq

# Search WordPress VIP documentation
echo '{"jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": {"name": "wp_vip_search", "arguments": {"query": "deployment"}}}' | wordpress-docs-mcp | jq

# Look up WordPress function
echo '{"jsonrpc": "2.0", "id": 5, "method": "tools/call", "params": {"name": "wp_function_lookup", "arguments": {"function_name": "get_post"}}}' | wordpress-docs-mcp | jq

📚 Documentação

  • Arquitetura MCP - Aprenda como os servidores MCP funcionam, integração com Node.js e comunicação com o Claude
  • Guia de Desenvolvimento - Como adicionar novas ferramentas do WordPress e fluxo de trabalho de desenvolvimento

🤝 Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Para mudanças significativas, abra uma issue primeiro para discutir o que você gostaria de alterar.

  1. Faça um fork do repositório
  2. Crie sua branch de funcionalidade (git checkout -b feature/AmazingFeature)
  3. Faça commit das suas alterações (git commit -m 'Add some AmazingFeature')
  4. Envie para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

📝 Licença

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

🔗 Links

⚡ Novidades

Versão 1.0.0

  • ✅ Pesquisa na documentação do WordPress.org com filtro por tipo de conteúdo
  • ✅ Pesquisa na documentação do WordPress VIP com fallback de web scraping
  • ✅ Consulta de funções do WordPress com scraping direto de URL
  • ✅ Tratamento abrangente de erros e validação
  • ✅ Suporte para Claude Code e Claude Desktop
  • ✅ Busca de documentação em tempo real (sem conteúdo em cache/desatualizado)

Feito com ❤️ para as comunidades WordPress e Claude