项目简介
Eventbrite MCP服务器是一个基于Model Context Protocol (MCP) 构建的应用后端,旨在让AI助手(如Claude)能够便捷地访问Eventbrite的活动数据。通过此服务器,AI助手可以搜索活动、获取活动详细信息、查询场馆信息以及检索活动类别,从而扩展AI在活动发现和信息获取方面的能力。
主要功能点
- 活动搜索: 根据关键词、地点、日期、类别等条件搜索Eventbrite上的活动。
- 活动详情: 获取指定Eventbrite活动的详细信息,包括活动名称、描述、时间、地点等。
- 场馆信息: 查询Eventbrite场馆的详细信息。
- 活动类别: 获取Eventbrite支持的活动类别列表。
安装步骤
本MCP服务器可以通过以下两种方式安装:
1. 从 NPM 安装 (推荐):
打开终端并执行以下命令,全局安装 '@ibraheem4/eventbrite-mcp' 包:
npm install -g @ibraheem4/eventbrite-mcp
2. 从源代码安装:
如果您希望从源代码安装或进行开发,请按照以下步骤操作:
- 克隆 GitHub 仓库到本地:
git clone https://github.com/ibraheem4/eventbrite-mcp.git cd eventbrite-mcp - 安装项目依赖:
npm install - 构建项目:
npm run build
服务器配置
要将此MCP服务器配置到您的MCP客户端(例如 Claude),您需要提供服务器的启动命令和参数。以下是配置信息,您需要根据您的MCP客户端配置界面进行填写。
重要: 在配置服务器之前,您需要先获取 Eventbrite API 密钥。请访问 Eventbrite Developer Portal 注册并创建应用以获取API密钥。
MCP服务器配置信息 (JSON 格式):
{ "mcpServers": { "eventbrite": { // 服务器名称,可以自定义,例如 "eventbrite" "command": "npx", // 启动命令,通常为 "npx" 或 Node.js 可执行文件路径 "args": ["-y", "@ibraheem4/eventbrite-mcp"], // 启动参数,这里指定运行 @ibraheem4/eventbrite-mcp 包 "env": { "EVENTBRITE_API_KEY": "YOUR_EVENTBRITE_API_KEY_HERE" // 环境变量,用于设置 Eventbrite API 密钥,请替换为您的实际密钥 }, "disabled": false, // 设置为 false 表示启用该服务器 "autoApprove": [] // 自动批准列表,通常为空数组 } } }
配置说明:
- '"eventbrite"': 服务器的名称,您可以自定义,用于在MCP客户端中标识该服务器。
- '"command": "npx"' 和 '"args": ["-y", "@ibraheem4/eventbrite-mcp"]': 指定了启动服务器的命令。这里使用 'npx' 直接运行全局安装的 '@ibraheem4/eventbrite-mcp' 包。如果您是从源代码安装,并且在项目根目录下运行,可以修改 '"args"' 为 '["./build/index.js"]',并可能需要调整 '"command"' 为 Node.js 可执行文件路径,例如 '"command": "/usr/bin/node"' 或 '"command": "node"'。
- '"env": { "EVENTBRITE_API_KEY": "YOUR_EVENTBRITE_API_KEY_HERE" }': 非常重要。 您需要将 '"YOUR_EVENTBRITE_API_KEY_HERE"' 替换为您在 Eventbrite 开发者平台获取的 实际 API 密钥。 该密钥作为环境变量 'EVENTBRITE_API_KEY' 传递给服务器。
- '"disabled": false': 确保设置为 'false' 以启用此MCP服务器。
- '"autoApprove": []': 通常保持为空数组。
配置示例 (以 Claude Desktop App 为例):
将上述 JSON 配置信息添加到 Claude Desktop App 的配置文件 '~/Library/Application Support/Claude/claude_desktop_config.json' (macOS) 或相应的配置文件路径中。
基本使用方法
配置完成后,您可以在支持 MCP 协议的客户端(如 Claude)中使用自然语言指令来调用 Eventbrite MCP 服务器的功能。例如:
- 询问 "搜索纽约下周末的音乐活动"
- 询问 "获取 Eventbrite 活动 ID 为 123456789 的活动详情"
- 询问 "Eventbrite 上有哪些类型的活动?"
- 询问 "告诉我场馆 ID 为 987654321 的场馆信息"
客户端会将这些自然语言指令转换为对 MCP 服务器的工具调用,服务器会调用 Eventbrite API 获取数据并返回给客户端。
信息
分类
网页与API