이벤트브라이트 MCP 서버

Eventbrite 이벤트 관리, 보고 및 분석을 위한 MCP(Model Context Protocol) 서버입니다.

프로젝트 개요

이 MCP 서버는 Eventbrite API와 통합되어 이벤트 관리, 참석자 추적, 분석 보고서 생성 도구를 제공합니다. Claude 및 기타 MCP 클라이언트와 연동하여 AI 기반 이벤트 관리 기능을 제공하도록 설계되었습니다.

Related MCP server: Microsoft Events MCP Server

프로젝트 상태

현재 다음 도구가 구현되어 있습니다.

• list_events : 선택적 필터링을 사용하여 이벤트 나열

• get_event_details : 특정 이벤트에 대한 자세한 정보를 가져옵니다.

특징

• 이벤트 관리 : 이벤트 보기, 생성, 업데이트 및 게시

• 참석자 관리 : 참석자 목록, 세부 정보 보기, 참석자 데이터 내보내기

• 판매 분석 : 티켓 판매, 수익 및 추세에 대한 보고서 생성

• 사용자 정의 보고서 : 사용자 정의 보고서 템플릿을 만들고 저장합니다.

• 데이터 시각화 : 주요 지표에 대한 차트와 그래프 생성

구현 계획

1단계: 설정 및 핵심 인프라

• [x] 프로젝트 구조 초기화

• [x] MCP 서버 프레임워크 설정

• [x] Eventbrite API 인증 구현

• [x] 기본 API 래퍼 함수 생성

2단계: 이벤트 관리 도구

• [x] list_events 도구 구현

• [x] get_event_details 도구 구현

• [ ] create_event 도구 구현

• [ ] update_event 도구 구현

• [ ] publish_event 도구 구현

3단계: 참석자 관리 도구

• [ ] list_attendees 도구 구현

• [ ] get_attendee_details 도구 구현

• [ ] export_attendee_data 도구 구현

4단계: 분석 및 보고

• [ ] generate_sales_report 도구 구현

• [ ] generate_attendance_report 도구를 구현합니다.

• [ ] generate_analytics_chart 도구 구현

• [ ] 데이터 시각화 구성요소 생성

5단계: 테스트 및 문서화

• [x] 테스트 MCP 클라이언트 구현

• [x] 이벤트 뷰어 웹 인터페이스 생성

• [x] 이벤트 목록 기능의 종합 테스트

• [ ] 포괄적인 사용 설명서를 작성합니다.

• [ ] 예제 워크플로 생성

개발 로그

시작하기

필수 조건

• Node.js(v18 이상)

• Eventbrite API 토큰(Eventbrite 계정의 비공개 토큰)

• Claude Desktop 또는 기타 MCP 클라이언트

설치

지엑스피1

Eventbrite API 토큰 받기

1. Eventbrite 계정에 로그인하세요

2. 계정 설정 > 개발자 링크 > API 키로 이동하세요.

3. 개인 토큰을 복사하세요

4. .env 파일에 EVENTBRITE_API_KEY=your_token_here로 추가하세요.

Claude Desktop을 사용한 구성

macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json 에 있는 claude_desktop_config.json 에 다음을 추가합니다.

옵션 1: npm start 사용

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

옵션 2: 직접 Node.js 실행(권장)

{
  "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"
      }
    }
  }
}

테스트 및 이벤트 뷰어

이 프로젝트에는 MCP 서버를 테스트하고 이벤트를 보기 위한 도구가 포함되어 있습니다.

MCP 클라이언트 테스트

test-mcp-client-final.js 스크립트를 사용하면 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"

이벤트 뷰어

이 프로젝트에는 이벤트를 표시하고 필터링하기 위한 웹 기반 이벤트 뷰어가 포함되어 있습니다.

# Start the events viewer
node view-events.js

로컬 웹 서버가 시작되고 브라우저에 이벤트 뷰어가 열립니다. 뷰어를 통해 다음 작업을 수행할 수 있습니다.

• Eventbrite에서 검색된 모든 이벤트 보기

• 날짜 범위별로 이벤트 필터링

• 상태별로 이벤트 필터링

• 자세한 이벤트 정보 보기

events.json 파일이 없으면 스크립트는 자동으로 Eventbrite API에서 이벤트를 가져옵니다.

특허

MIT