Eventbrite MCP Server

by vishalsachdev
Verified

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.

Eventbrite MCP サーバー

Eventbrite イベント管理、レポート、分析用の Model Context Protocol (MCP) サーバー。

プロジェクト概要

この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] イベントビューアのWebインターフェースを作成する
  • [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 クライアント

インストール

# 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

Eventbrite APIトークンの取得

  1. Eventbriteアカウントにログイン
  2. アカウント設定 > 開発者リンク > APIキーに移動します
  3. プライベートトークンをコピーする
  4. EVENTBRITE_API_KEY=your_token_here として .env ファイルに追加します。

Claude Desktop による構成

claude_desktop_config.json (macOS では~/Library/Application Support/Claude/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"

イベントビューア

このプロジェクトには、イベントを表示およびフィルタリングするための Web ベースのイベント ビューアーが含まれています。

# Start the events viewer node view-events.js

これにより、ローカルウェブサーバーが起動し、ブラウザでイベントビューアーが開きます。ビューアーでは以下の操作が可能です。

  • Eventbriteから取得したすべてのイベントを表示
  • 日付範囲でイベントをフィルタリング
  • ステータスでイベントをフィルタリング
  • 詳細なイベント情報を見る

events.jsonファイルが存在しない場合は、スクリプトは Eventbrite API からイベントを自動的に取得します。

ライセンス

マサチューセッツ工科大学

ID: p9rtm9xlub