JinDaGe - eventbrite-mcp MCP Details

article

README

🚀 Eventbrite MCP 服务器

Eventbrite MCP 服务器是一个模型上下文协议（MCP）服务器，它提供了与 Eventbrite API 交互的工具。借助该服务器，AI 助手能够搜索活动、获取活动详情、检索场地信息等，为活动信息的获取提供了便利。

🚀 快速开始

配置完成后，您可以通过以下命令运行服务器：

npm start

✨ 主要特性

根据各种标准（地点、日期、类别等）搜索活动
获取特定活动的详细信息
检索场地信息
获取活动类别的列表

📦 安装指南

从 NPM

npm install -g @ibraheem4/eventbrite-mcp

从源代码

克隆此仓库
安装依赖项：

npm install

构建项目：

npm run build

💻 使用示例

基础用法

配置完成后，您可以让 Claude 使用 Eventbrite MCP 工具：

# 搜索纽约下周音乐会
“搜索纽约下周音乐会”
# 告诉我活动 123456789 的详细信息
“告诉我活动 123456789 的详细信息”
# 有哪些活动类别可用？
“有哪些活动类别可用？”
# 告诉我场地 987654321 的信息
“告诉我场地 987654321 的信息”

📚 详细文档

开发

以开发模式运行

npm run dev

这将监视源文件中的更改，自动重建项目并重新启动服务器。

运行 MCP 服务器

您可以使用提供的运行脚本运行 MCP 服务器：

./run.sh

这将在 1337 端口上以 JSON 格式运行 MCP 服务器。

以调试模式运行

如果您想在调试模式下运行，请执行以下操作：

npm run dev

然后访问http://localhost:3000进行测试。

配置

环境变量

要配置 MCP 服务器，您可以设置以下环境变量：

PORT：指定运行服务器的端口（默认值为 3000）
EVENTBRITE_API_KEY：您的 Eventbrite API 密钥

例如，在 Linux 中，您可以使用以下命令：

export PORT=3001
export EVENTBRITE_API_KEY='your_api_key_here'

在 Windows 中：

set PORT=3001
set EVENTBRITE_API_KEY=your_api_key_here

接口说明

搜索活动

GET /api/events

参数： | 参数 | 详情 | |------|------| | q | 搜索关键字（如“音乐会”、“展览”等） | | location | 地点名称或邮政编码 | | start_date | 开始日期（ISO 格式） | | end_date | 结束日期（ISO 格式） | | page | 页码 | | per_page | 每页显示的记录数 |

获取活动详情

GET /api/events/:eventId

参数： | 参数 | 详情 | |------|------| | eventId | Eventbrite 活动 ID |

获取类别

GET /api/categories

无参数。

获取场地信息

GET /api/venues/:venueId

参数： | 参数 | 详情 | |------|------| | venueId | Eventbrite 场地 ID |

📄 许可证

本项目采用 MIT 许可证。

eventbrite-mcp