活动管理协议服务器

Eventbrite MCP服务器

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

项目概述

此MCP服务器与Eventbrite API集成，提供用于管理事件、跟踪与会者和生成分析报告的工具。它旨在与Claude和其他MCP客户端合作，提供人工智能辅助的事件管理功能。

项目状态

目前，已实施以下工具：

• 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 工具

第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. 将其添加到.env文件中，作为EVENTBRITE_API_KEY=your_token_here

使用Claude Desktop进行配置

将以下内容添加到您的 claude_desktop_config.json （位于 ~/Library/Application Support/Claude/claude_desktop_config.json 在 macOS 上：

选项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"

事件查看器

该项目包括一个基于网络的事件查看器，用于显示和过滤事件：

# Start the events viewer
node view-events.js

这将启动一个本地web服务器，并在浏览器中打开事件查看器。查看器允许您：

• 查看从Eventbrite检索到的所有事件
• 按日期范围筛选事件
• 按状态筛选事件
• 查看详细事件信息

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

许可证

麻省理工学院