Eventbrite MCP 服务器

用于 Eventbrite 活动管理、报告和分析的模型上下文协议 (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-03-20	启动项目规划	已完成
2025-03-20	审查 Eventbrite API 文档	已完成
2025-03-20	审查 MCP 服务器实现示例	已完成
2025-03-20	创建初始项目文档	已完成
2025-03-20	实现核心 MCP 服务器结构	已完成
2025-03-20	实现 Eventbrite API 客户端	已完成
2025-03-20	实现 list_events 和 get_event_details 工具	已完成
2025-03-20	创建测试 MCP 客户端	已完成
2025-03-20	实现活动查看器 UI	已完成
2025-03-20	测试使用日期过滤的活动检索	已完成

快速开始

前提条件

• Node.js (v18 或更高版本)
• Eventbrite API 令牌（来自您的 Eventbrite 帐户的私有令牌）
• Claude Desktop 或其他 MCP 客户端

安装

# 克隆存储库
git clone https://github.com/yourusername/eventbrite-mcp.git

# 安装依赖项
cd eventbrite-mcp
npm install

# 配置环境变量
cp .env.example .env
# 使用您的 Eventbrite API 令牌编辑 .env

# 构建项目
npm run build

# 启动服务器
npm start

获取您的 Eventbrite API 令牌

1. 登录到您的 Eventbrite 帐户
2. 转到帐户设置 > 开发者链接 > API 密钥
3. 复制您的私有令牌
4. 将其添加到您的 .env 文件中，格式为 EVENTBRITE_API_KEY=your_token_here

使用 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 服务器的活动检索功能：

# 使用默认参数运行测试客户端
node test-mcp-client-final.js

# 使用自定义日期范围运行
node test-mcp-client-final.js --start-date="2025-01-01" --end-date="2025-12-31"

# 使用特定状态过滤器运行
node test-mcp-client-final.js --status="live"

活动查看器

该项目包括一个基于 Web 的活动查看器，用于显示和过滤活动：

# 启动活动查看器
node view-events.js

这将启动一个本地 Web 服务器并在您的浏览器中打开活动查看器。查看器允许您：

• 查看从 Eventbrite 检索的所有活动
• 按日期范围过滤活动
• 按状态过滤活动
• 查看详细的活动信息

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

许可证

MIT