Eventbrite

Gerencie eventos, relatórios e análises no Eventbrite.

Documentação

Servidor MCP Eventbrite

Um servidor Model Context Protocol (MCP) para gerenciamento de eventos, relatórios e análises do Eventbrite.

Visão Geral do Projeto

Este servidor MCP integra-se à API do Eventbrite para fornecer ferramentas de gerenciamento de eventos, acompanhamento de participantes e geração de relatórios analíticos. Ele foi projetado para funcionar com Claude e outros clientes MCP, oferecendo recursos de gerenciamento de eventos assistidos por IA.

Status do Projeto

Status	Descrição
🚧 Em Andamento	Funcionalidade básica implementada

Atualmente, as seguintes ferramentas estão implementadas:

list_events: Listar eventos com filtragem opcional
get_event_details: Obter informações detalhadas sobre um evento específico

Recursos

Gerenciamento de Eventos: Visualizar, criar, atualizar e publicar eventos
Gerenciamento de Participantes: Listar participantes, visualizar detalhes e exportar dados de participantes
Análise de Vendas: Gerar relatórios sobre vendas de ingressos, receita e tendências
Relatórios Personalizados: Criar e salvar modelos de relatórios personalizados
Visualização de Dados: Gerar gráficos e diagramas para métricas-chave

Plano de Implementação

Fase 1: Configuração e Infraestrutura Principal

Inicializar a estrutura do projeto
Configurar o framework do servidor MCP
Implementar autenticação da API do Eventbrite
Criar funções básicas de wrapper da API

Fase 2: Ferramentas de Gerenciamento de Eventos

Implementar ferramenta list_events
Implementar ferramenta get_event_details
Implementar ferramenta create_event
Implementar ferramenta update_event
Implementar ferramenta publish_event

Fase 3: Ferramentas de Gerenciamento de Participantes

Implementar ferramenta list_attendees
Implementar ferramenta get_attendee_details
Implementar ferramenta export_attendee_data

Fase 4: Análise e Relatórios

Implementar ferramenta generate_sales_report
Implementar ferramenta generate_attendance_report
Implementar ferramenta generate_analytics_chart
Criar componentes de visualização de dados

Fase 5: Testes e Documentação

Implementar cliente MCP de teste
Criar interface web de visualização de eventos
Testes abrangentes da funcionalidade de listagem de eventos
Criar documentação de uso abrangente
Criar fluxos de trabalho de exemplo

Registro de Desenvolvimento

Data	Descrição	Status
2025-03-20	Planejamento do projeto iniciado	Concluído
2025-03-20	Revisão da documentação da API do Eventbrite	Concluído
2025-03-20	Revisão de exemplos de implementação do servidor MCP	Concluído
2025-03-20	Criação da documentação inicial do projeto	Concluído
2025-03-20	Implementação da estrutura principal do servidor MCP	Concluído
2025-03-20	Implementação do cliente da API do Eventbrite	Concluído
2025-03-20	Implementação das ferramentas list_events e get_event_details	Concluído
2025-03-20	Criação do cliente MCP de teste	Concluído
2025-03-20	Implementação da interface de visualização de eventos	Concluído
2025-03-20	Teste de recuperação de eventos com filtragem por data	Concluído

Primeiros Passos

Pré-requisitos

Node.js (v18 ou superior)
Token da API do Eventbrite (token privado da sua conta Eventbrite)
Claude Desktop ou outro cliente MCP

Instalação

# Clone the repository
git clone https://github.com/yourusername/eventbrite-mcp.git

# Install dependencies
cd eventbrite-mcp
npm install

# Configure environment variables
cp .env.example .env
# Edit .env with your Eventbrite API token

# Build the project
npm run build

# Start the server
npm start

Obtendo seu Token da API do Eventbrite

Faça login na sua conta Eventbrite
Vá para Configurações da Conta > Links de Desenvolvedor > Chaves de API
Copie seu token privado
Adicione-o ao seu arquivo .env como EVENTBRITE_API_KEY=seu_token_aqui

Configuração com Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json (localizado em ~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

Opção 1: Usando npm start

{
  "mcpServers": {
    "eventbrite": {
      "command": "npm",
      "args": ["start"],
      "cwd": "/path/to/eventbrite-mcp",
      "env": {
        "EVENTBRITE_API_KEY": "your_api_token_here"
      }
    }
  }
}

Opção 2: Execução direta com Node.js (recomendado)

{
  "mcpServers": {
    "eventbrite": {
      "command": "node",
      "args": ["/path/to/eventbrite-mcp/dist/index.js"],
      "cwd": "/path/to/eventbrite-mcp",
      "env": {
        "EVENTBRITE_API_KEY": "your_api_token_here"
      }
    }
  }
}

Testes e Visualizador de Eventos

Este projeto inclui ferramentas para testar o servidor MCP e visualizar eventos:

Cliente MCP de Teste

O script test-mcp-client-final.js permite testar a funcionalidade de recuperação de eventos do servidor MCP:

# Run the test client with default parameters
node test-mcp-client-final.js

# Run with custom date range
node test-mcp-client-final.js --start-date="2025-01-01" --end-date="2025-12-31"

# Run with specific status filter
node test-mcp-client-final.js --status="live"

Visualizador de Eventos

O projeto inclui um visualizador de eventos baseado na web para exibir e filtrar eventos:

# Start the events viewer
node view-events.js

Isso iniciará um servidor web local e abrirá o visualizador de eventos no seu navegador. O visualizador permite:

Visualizar todos os eventos recuperados do Eventbrite
Filtrar eventos por intervalo de datas
Filtrar eventos por status
Visualizar informações detalhadas do evento

Se o arquivo events.json não existir, o script buscará automaticamente os eventos da API do Eventbrite.

Licença

MIT