活动搜索助手
该服务器为AI助手提供了与Eventbrite API交互的工具,允许用户搜索活动、获取活动详情、检索场地信息以及列出活动类别。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"eventbrite": {
"args": [
"-y",
"@ibraheem4/eventbrite-mcp"
],
"autoApprove": [],
"command": "npx",
"disabled": false,
"env": {
"EVENTBRITE_API_KEY": "your-eventbrite-api-key"
}
}
}
}
该服务需要配置环境变量:EVENTBRITE_API_KEY
可用工具 (4 个)
该服务在 MCP 协议中暴露的工具,AI 可按需调用
search_events 8 个参数
Search for Eventbrite events based on various criteria
该工具无需必填参数,直接调用即可
get_event 1 个参数 需填 1 项
Get detailed information about a specific Eventbrite event
必填参数:event_id
get_categories
Get a list of Eventbrite event categories
该工具无需必填参数,直接调用即可
get_venue 1 个参数 需填 1 项
Get information about a specific Eventbrite venue
必填参数:venue_id
服务介绍
Eventbrite MCP 服务器
这是一个提供与 Eventbrite API 交互工具的 Model Context Protocol (MCP) 服务器。它允许 AI 助手根据各种条件搜索活动、获取活动详细信息、检索场地信息等。
特性
- 根据各种条件(位置、日期、类别等)搜索活动
- 获取特定活动的详细信息
- 检索场地信息
- 获取活动类别的列表
安装
从 NPM 安装
npm install -g @ibraheem4/eventbrite-mcp
从源代码安装
- 克隆此仓库
- 安装依赖项:
npm install - 构建项目:
npm run build
开发
以开发模式运行
npm run dev
这将监视源文件的变化,重新构建项目,并自动重启服务器。
运行 MCP 服务器
你可以使用提供的运行脚本来运行 MCP 服务器:
./run.sh
这将使用 supergateway 启动 MCP 服务器。
使用 Inspector 运行
要使用 Inspector 运行 MCP 服务器,可以使用以下命令:
npm run inspector
这将启动 Inspector,它为测试 MCP 服务器提供了一个 Web 界面。Inspector 将在 http://localhost:5173 上可用。
手动运行
你可以手动运行 MCP 服务器:
npx -y supergateway --port 1337 --stdio "./build/index.js"
或者简单地使用提供的运行脚本:
./run.sh
测试
# Run all tests
npm test
# Run tests in watch mode
npm run test:watch
# Run tests with coverage
npm run test:coverage
# Run integration tests
npm run test:integration
# Test the API directly
npm run test:api
配置
要使用此 MCP 服务器,你需要:
- 从 Eventbrite 开发者门户 获取 Eventbrite API 密钥
- 通过以下方式之一设置你的 API 密钥:
- 在项目根目录中创建一个
.env文件(从.env.example复制):EVENTBRITE_API_KEY=your_eventbrite_api_key_here - 或者作为环境变量提供:
export EVENTBRITE_API_KEY=your_eventbrite_api_key_here - 或者在 MCP 设置文件中配置(见下文)
- 在项目根目录中创建一个
- 测试你的 API 密钥:
./test-api-key.js - 在你的 MCP 设置文件中配置 MCP 服务器
对于 Claude 桌面应用程序
在 ~/Library/Application Support/Claude/claude_desktop_config.json 文件(macOS 上)中添加以下内容:
{
"mcpServers": {
"eventbrite": {
"command": "npx",
"args": ["-y", "@ibraheem4/eventbrite-mcp"],
"env": {
"EVENTBRITE_API_KEY": "your-eventbrite-api-key"
},
"disabled": false,
"autoApprove": []
}
}
}
对于 Claude 开发环境
在 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 文件(macOS 上)中添加以下内容:
{
"mcpServers": {
"eventbrite": {
"command": "npx",
"args": ["-y", "@ibraheem4/eventbrite-mcp"],
"env": {
"EVENTBRITE_API_KEY": "your-eventbrite-api-key"
},
"disabled": false,
"autoApprove": []
}
}
}
快速开始
如果你是从源代码安装的,可以使用提供的运行脚本:
./run.sh
这将构建项目并启动 MCP 服务器。
可用工具
search_events
根据各种条件搜索 Eventbrite 活动。
参数:
query(字符串,可选):事件搜索查询location(对象,可选):搜索周围的地点latitude(数字,必填):纬度坐标longitude(数字,必填):经度坐标within(字符串,可选):距离(例如,'10km','10mi')
categories(字符串数组,可选):按类别ID过滤start_date(字符串,可选):开始日期,ISO格式(例如,'2023-01-01T00:00:00Z')end_date(字符串,可选):结束日期,ISO格式(例如,'2023-12-31T23:59:59Z')price(字符串,可选):按'free'或'paid'事件过滤page(数字,可选):分页的页码page_size(数字,可选):每页的结果数(最大100)
get_event
获取特定Eventbrite事件的详细信息。
参数:
event_id(字符串,必填):Eventbrite事件ID
get_categories
获取Eventbrite事件类别的列表。
无需参数。
get_venue
获取特定Eventbrite场地的信息。
参数:
venue_id(字符串,必填):Eventbrite场地ID
可用资源
事件详情资源
URI模板: eventbrite://events/{eventId}
获取特定Eventbrite事件的详细信息。
示例用法
配置完成后,您可以要求Claude使用Eventbrite MCP工具:
- "搜索下周末在纽约的音乐活动"
- "获取ID为123456789的Eventbrite事件的详细信息"
- "Eventbrite上有哪些类别的活动?"
- "告诉我ID为987654321的场地信息"
许可证
MIT