Erick Wendel Contributions

erickwendel-contributions-mcp

Um servidor Model Context Protocol (MCP) que fornece ferramentas para consultar as contribuições de Erick Wendel em diferentes plataformas. Consulte palestras, postagens de blog e vídeos usando linguagem natural através do Claude, Cursor ou similares. Este projeto foi construído usando a IDE Cursor com o agente padrão (versão de teste).

Início Rápido

Use este servidor MCP diretamente com Claude Desktop ou Cursor sem instalação:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Adicione esta configuração a:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
• Cursor: ~/.cursor/mcp.json

Ferramentas Disponíveis

Este servidor MCP fornece as seguintes capacidades:

Ferramentas

• get-talks: Recupera uma lista paginada de palestras com filtragem opcional

  • Suporta filtragem por ID, título, idioma, cidade, país e ano
  • Pode retornar contagens agrupadas por idioma, país ou cidade

• get-posts: Busca postagens com filtragem e paginação opcionais

  • Suporta filtragem por ID, título, idioma e portal

• get-videos: Recupera vídeos com filtragem e paginação opcionais

  • Suporta filtragem por ID, título e idioma

• check-status: Verifica se a API está ativa e respondendo

Prompts

• find-content: Gera consultas para encontrar conteúdo específico por tipo, tópico e idioma
• summarize-activity: Cria resumos da atividade de conteúdo por ano

Recursos

• erickwendel://about: Informações do servidor e metadados de capacidades
• erickwendel://statistics: Estatísticas de conteúdo e consultas disponíveis

Integração com Ferramentas de IA

Inspecionar Capacidades do Servidor MCP

Você pode inspecionar as capacidades deste servidor MCP usando o MCP Inspector:

npm run inspect

Isso mostrará todas as ferramentas disponíveis, seus parâmetros e como usá-las.

Configuração

1. Certifique-se de estar usando Node.js v20+

node -v
# v20.x.x or higher

2. Clone este repositório:

git clone https://github.com/erickwendel/erickwendel-contributions-mcp.git
cd erickwendel-contributions-mcp

3. Instale as dependências:

npm ci

4. Execute o servidor:

npm start

Integração com Ferramentas de IA

Configuração do Cursor

Adicione a seguinte configuração a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Certifique-se de que o chat do Cursor esteja no modo Agente selecionando "Agente" no menu suspenso no canto inferior esquerdo e pergunte "quantos vídeos foram publicados sobre JavaScript em 2024":

Desenvolvimento Local

Para desenvolvimento local, use o caminho absoluto para o projeto:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

Configuração do Claude Desktop

1. Vá para as configurações do Claude
2. Clique na aba Desenvolvedor
3. Clique em editar configuração
4. Abra a configuração em um editor de código
5. Adicione a seguinte configuração a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

Desenvolvimento Local

Para desenvolvimento local, use o caminho absoluto para o projeto:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

MCPHost com Ollama (Alternativa Gratuita)

Se você não tem acesso ao Claude Desktop ou Cursor, pode usar MCPHost com Ollama como alternativa gratuita.

1. Instale o MCPHost:

go install github.com/mark3labs/mcphost@latest

2. Crie um arquivo de configuração (ex.: ./mcp.jsonc):

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "npx",
      "args": ["-y", "@erickwendel/contributions-mcp"]
    }
  }
}

3. Execute com Ollama:

ollama pull MODEL_NAME
mcphost --config ./mcp.jsonc -m ollama:MODEL_NAME

Desenvolvimento Local

Para desenvolvimento local, atualize a configuração:

{
  "mcpServers": {
    "erickwendel-contributions": {
      "command": "node",
      "args": ["--experimental-strip-types", "ABSOLUTE_PATH_TO_PROJECT/src/index.ts"]
    }
  }
}

Exemplos de Consultas

Aqui estão alguns exemplos de consultas que você pode fazer ao Claude, Cursor ou qualquer Cliente MCP:

1. "Quantas palestras foram dadas em 2023?"

2. "Mostre-me palestras em espanhol"

3. "Encontre postagens sobre WebXR"

Desenvolvimento

Recursos

• Construído com Model Context Protocol (MCP)
• Capacidades MCP Completas: Ferramentas, Prompts e Recursos
• Type-safe com TypeScript e validação de esquema Zod
• Suporte nativo a TypeScript no Node.js sem transpilação
• SDK gerado usando GenQL
• Arquitetura modular com separação de preocupações
• Transporte padrão de E/S para fácil integração
• Tratamento estruturado de erros
• Compatível com Claude Desktop, Cursor e MCPHost (alternativa gratuita)

Nota: Este projeto requer Node.js v23+ pois usa o suporte nativo a TypeScript adicionado no último ano.

Arquitetura

O código segue uma estrutura modular:

src/
  ├── config/      # Configuration settings
  ├── types/       # TypeScript interfaces and types
  ├── tools/       # MCP tool implementations
  ├── utils/       # Utility functions
  ├── services/    # API service layer
  └── index.ts     # Main entry point

Testes

Para executar a suíte de testes:

npm test

Para modo de desenvolvimento com observação (watch):

npm run test:dev

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Autor

Erick Wendel

Licença

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