local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Integrates with the Eventbrite API to provide tools for managing events, tracking attendees, and generating analytics reports, including capabilities for viewing, creating, updating, and publishing events, as well as attendee management and sales analytics features.

이벤트브라이트 MCP 서버

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

프로젝트 개요

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

프로젝트 상태

상태	설명
🚧 진행 중	기본 기능 구현됨

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

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] 이벤트 목록 기능의 종합 테스트
[ ] 포괄적인 사용 설명서를 작성합니다.
[ ] 예제 워크플로 생성

개발 로그

날짜	설명	상태
2025년 3월 20일	프로젝트 계획이 시작되었습니다	완전한
2025년 3월 20일	Eventbrite API 문서를 검토했습니다.	완전한
2025년 3월 20일	MCP 서버 구현 사례를 검토했습니다.	완전한
2025년 3월 20일	초기 프로젝트 문서 작성	완전한
2025년 3월 20일	핵심 MCP 서버 구조 구현	완전한
2025년 3월 20일	Eventbrite API 클라이언트 구현	완전한
2025년 3월 20일	list_events 및 get_event_details 도구를 구현했습니다.	완전한
2025년 3월 20일	테스트 MCP 클라이언트를 생성했습니다.	완전한
2025년 3월 20일	이벤트 뷰어 UI 구현	완전한
2025년 3월 20일	날짜 필터링을 통한 테스트된 이벤트 검색	완전한

시작하기

필수 조건

Node.js(v18 이상)
Eventbrite API 토큰(Eventbrite 계정의 비공개 토큰)
Claude Desktop 또는 기타 MCP 클라이언트

설치

지엑스피1

Eventbrite API 토큰 받기

Eventbrite 계정에 로그인하세요
계정 설정 > 개발자 링크 > API 키로 이동하세요.
개인 토큰을 복사하세요
.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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Eventbrite API와 통합되어 이벤트 보기, 참석자 추적, 분석 보고서 생성을 위한 AI 지원 이벤트 관리 기능을 제공합니다.

Eventbrite MCP Server