Eventbrite MCP 服务器

用于 Eventbrite 事件管理、报告和分析的模型上下文协议 (MCP) 服务器。

项目概述

此 MCP 服务器与 Eventbrite API 集成，提供用于管理活动、追踪参与者和生成分析报告的工具。它旨在与 Claude 和其他 MCP 客户端协同工作，提供 AI 辅助的活动管理功能。

Related MCP server: Microsoft Events MCP Server

项目状态

目前已实施以下工具：

• list_events ：列出带有可选过滤的事件

• get_event_details ：获取有关特定事件的详细信息

特征

• 事件管理：查看、创建、更新和发布事件

• 参会者管理：列出参会者、查看详细信息以及导出参会者数据

• 销售分析：生成有关门票销售、收入和趋势的报告

• 自定义报告：创建并保存自定义报告模板

• 数据可视化：为关键指标生成图表和图形

实施计划

第一阶段：设置和核心基础设施

• [x] 初始化项目结构

• [x] 设置 MCP 服务器框架

• [x] 实现 Eventbrite API 身份验证

• [x] 创建基本的 API 包装函数

第二阶段：事件管理工具

• [x] 实现list_events工具

• [x] 实现get_event_details工具

• [ ] 实现create_event工具

• [ ] 实现update_event工具

• [ ] 实现publish_event工具

第三阶段：与会者管理工具

• [ ] 实现list_attendees工具

• [ ] 实现get_attendee_details工具

• [ ] 实现export_attendee_data工具

第四阶段：分析与报告

• [ ] 实现generate_sales_report工具

• [ ] 实现generate_attendance_report工具

• [ ] 实现generate_analytics_chart工具

• [ ] 创建数据可视化组件

第五阶段：测试和文档

• [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

这将启动本地 Web 服务器并在浏览器中打开事件查看器。该查看器允许您执行以下操作：

• 查看从 Eventbrite 检索到的所有活动

• 按日期范围过滤事件

• 按状态过滤事件

• 查看详细活动信息

如果events.json文件不存在，脚本将自动从 Eventbrite API 获取事件。

执照

麻省理工学院