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 事件管理、报告和分析的模型上下文协议 (MCP) 服务器。

项目概述

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

项目状态

地位	描述
🚧 进行中	实现基本功能

目前已实施以下工具：

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] 全面测试事件列表功能
[ ] 创建全面的使用文档
[ ] 创建示例工作流程

开发日志

日期	描述	地位
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 令牌

登录您的 Eventbrite 帐户
前往“帐户设置”>“开发者链接”>“API 密钥”
复制您的私人令牌
将其作为 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 获取事件。

执照

麻省理工学院

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

与 Eventbrite API 集成，提供 AI 辅助事件管理功能，用于查看事件、跟踪参与者和生成分析报告。

Eventbrite MCP Server