Eventbrite MCP Server

Eventbrite MCP 服务

一个 Model Context Protocol（MCP）服务，提供通过自然语言访问 Eventbrite API 的能力。此服务可让你使用对话式 AI 创建、管理和交互 Eventbrite 活动。

功能

• 创建活动：通过自然语言描述创建新活动
• 列出活动：查看和筛选你的活动
• 更新活动：修改现有活动详情
• 发布活动：上线草稿活动
• 取消活动：在需要时取消活动
• 场地管理：创建和管理场地
• 类别支持：浏览和使用 Eventbrite 类别

设置

1. 获取 Eventbrite API 凭据

1. 前往 Eventbrite Developer Portal
2. 创建账户或登录
3. 创建新应用以获取 API 密钥
4. 记下你的组织 ID（可选，用于列出组织活动）

2. 环境变量

在此目录中创建 .env 文件，或设置以下环境变量：

EVENTBRITE_API_KEY=your_eventbrite_api_key_here
EVENTBRITE_ORGANIZATION_ID=your_organization_id_here  # Optional

3. 安装依赖项

cd src/mcp-servers/eventbrite
npm install

4. 构建（可选）

如果你想编译 TypeScript：

npm run build

使用方法

运行服务

# Development mode with auto-reload
npm run dev

# Production mode
npm start

MCP 客户端配置

将此服务添加到你的 MCP 客户端配置中（例如 Claude Desktop）：

{
  "mcpServers": {
    "eventbrite": {
      "command": "node",
      "args": ["/path/to/cyber-guard/src/mcp-servers/eventbrite/index.js"],
      "env": {
        "EVENTBRITE_API_KEY": "your_api_key_here",
        "EVENTBRITE_ORGANIZATION_ID": "your_org_id_here"
      }
    }
  }
}

可用工具

create_event

在 Eventbrite 上创建新活动。

参数：

• name（必填）：活动名称
• start_date（必填）：开始日期/时间，采用 ISO 8601 格式
• end_date（必填）：结束日期/时间，采用 ISO 8601 格式
• description：活动描述（允许使用 HTML）
• timezone：活动时区（默认：UTC）
• currency：货币代码（默认：USD）
• online_event：是否为线上活动（默认：false）
• listed：是否公开列出（默认：true）
• capacity：最多参加人数
• venue_name：场地名称（适用于线下活动）
• venue_address：场地地址
• venue_city：场地所在城市
• venue_region：场地所在州/地区
• venue_postal_code：场地邮政编码
• venue_country：场地所在国家/地区（2 位字母代码）
• category_id：Eventbrite 类别 ID
• subcategory_id：Eventbrite 子类别 ID

list_events

列出你的活动，可选筛选条件。

参数：

• status：按状态筛选（live、draft、canceled 等）
• order_by：排序方式（start_asc、start_desc、created_asc、created_desc）
• page：分页页码

get_event

获取特定活动的详细信息。

参数：

• event_id（必填）：活动 ID

update_event

更新现有活动。

参数：

• event_id（必填）：活动 ID
• name：新活动名称
• description：新描述
• start_date：新的开始日期/时间
• end_date：新的结束日期/时间
• timezone：新时区

publish_event

发布草稿活动，使其上线。

参数：

• event_id（必填）：活动 ID

cancel_event

取消活动。

参数：

• event_id（必填）：活动 ID

list_categories

列出可用的 Eventbrite 类别。

create_venue

创建新场地。

参数：

• name（必填）：场地名称
• address：街道地址
• city：城市
• region：州/地区
• postal_code：邮政编码
• country：国家/地区（2 位字母代码）

自然语言命令示例

连接到 MCP 客户端后，你可以使用如下自然语言：

• “创建一场下周五晚上 7 点举办的科技聚会活动，名称为 ‘AI and the Future’”
• “列出我所有即将举办的活动”
• “更新活动 123456789 的描述”
• “发布 ID 为 987654321 的草稿活动”
• “在旧金山创建一个名为 ‘Tech Hub’ 的场地”
• “显示所有可用的活动类别”

错误处理

此服务包含全面的错误处理，涵盖：

• 缺少 API 凭据
• 无效的活动数据
• 网络错误
• Eventbrite API 错误

开发

项目结构

src/mcp-servers/eventbrite/
├── index.ts          # Main server implementation
├── package.json      # Dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── README.md         # This file

贡献

1. Fork 此仓库
2. 创建功能分支
3. 进行更改
4. 全面测试
5. 提交拉取请求

许可证

MIT 许可证——详情请参阅主项目的许可证。

支持

如遇到以下相关问题：

• Eventbrite API：请查看 Eventbrite API 文档
• MCP 协议：请查看 Model Context Protocol 文档
• 此服务：请在主项目仓库中提交 issue