使用说明
Eventbrite MCP服务器
模型上下文协议(MCP)服务器,提供对Eventbrite API的自然语言访问。此服务器允许您使用会话式AI创建、管理Eventbrite事件并与之交互。
特性
- 创建事件:使用自然语言描述创建新事件
- 列出事件:查看和筛选您的事件
- 更新事件:修改现有事件详细信息
- 发布事件:使活动草稿生效
- 取消活动:需要时取消事件
- 场馆管理:创建和管理场馆
- 类别支持:浏览和使用Eventbrite类别
设置
1.获取Eventbrite API证书
- 首选 Eventbrite开发者门户
- 创建帐户或登录
- 创建一个新应用程序以获取您的API密钥
- 记下您的组织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:货币代码(默认值:美元)online_event:是否为在线事件(默认值:false)listed:是否公开列出(默认值:true)capacity:最大出席人数venue_name:场地名称(现场活动)venue_address:会场地址venue_city:场馆所在城市venue_region:场馆所在州/地区venue_postal_code:会场邮政编码venue_country:场馆所在国家(2个字母代码)category_id:Eventbrite类别IDsubcategory_id:Eventbrite子类别ID
list_事件
使用可选筛选列出您的事件。
参数:
status:按状态筛选(实时、草稿、已取消等)order_by:排序顺序(start_asc、start_desc、created_asc、created_desc)page:分页页码
get_event
获取特定事件的详细信息。
参数:
event_id(必填):事件ID
update_事件
更新现有事件。
参数:
event_id(必填):事件IDname:新事件名称description:新描述start_date:新的开始日期/时间end_date:新的结束日期/时间timezone:新时区
发布事件
发布活动草稿以使其生效。
参数:
event_id(必填):事件ID
cancel_事件
取消活动。
参数:
event_id(必填):事件ID
列表_类别
列出可用的Eventbrite类别。
创建_菜单
创建一个新的场所。
参数:
name(必填):场地名称address:街道地址city城市region:州/地区postal_code:邮政编码country:国家(2个字母的代码)
自然语言命令示例
连接到MCP客户端后,您可以使用自然语言,如:
- “下周五晚上7点举办一场名为‘人工智能与未来’的技术聚会”
- “列出我即将举办的所有活动”
- “更新事件123456789的描述”
- “发布ID为987654321的活动草稿”
- “在旧金山创建一个名为‘科技中心’的场所”
- “显示所有可用的事件类别”
错误处理
该服务器包括全面的错误处理功能,用于:
- 缺少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
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 彻底测试
- 提交拉取请求
许可证
MIT许可证-有关详细信息,请参阅主项目许可证。
支持
关于以下问题:
- Eventbrite API公司:检查 Eventbrite API文档
- MCP协议:检查 模型上下文协议文档
- 此服务器:在主项目存储库中打开问题