活动搜索助手

@ibraheem4/eventbrite-mcp
Hosted
1 Stars 1.1k 次浏览 ibraheem4 更新于 2026-08-23

该服务器为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

从源代码安装

  1. 克隆此仓库
  2. 安装依赖项:
    npm install
    
  3. 构建项目:
    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 服务器,你需要:

  1. Eventbrite 开发者门户 获取 Eventbrite API 密钥
  2. 通过以下方式之一设置你的 API 密钥:
    • 在项目根目录中创建一个 .env 文件(从 .env.example 复制):
      EVENTBRITE_API_KEY=your_eventbrite_api_key_here
      
    • 或者作为环境变量提供:
      export EVENTBRITE_API_KEY=your_eventbrite_api_key_here
      
    • 或者在 MCP 设置文件中配置(见下文)
  3. 测试你的 API 密钥:
    ./test-api-key.js
    
  4. 在你的 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

相关 MCP 服务