Eventbrite MCP サーバー

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

プロジェクト概要

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

• [x] イベントリスト機能の包括的なテスト

• [ ] 包括的な使用方法ドキュメントを作成する

• [ ] サンプルワークフローを作成する

開発ログ

はじめる

前提条件

• 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 からイベントを自動的に取得します。

ライセンス

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