返回 MCP 目录
public公开dns本地运行

eventbrite-mcp

Eventbrite MCP服务器是一个提供与Eventbrite API交互工具的服务,支持事件搜索、详情获取、场地信息查询等功能。

article

README

🚀 Eventbrite MCP 服务器

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

🚀 快速开始

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

npm start

✨ 主要特性

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

📦 安装指南

从 NPM

npm install -g @ibraheem4/eventbrite-mcp

从源代码

  1. 克隆此仓库
  2. 安装依赖项:
npm install
  1. 构建项目:
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 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端