MCP 服务器

Eventbrite MCP Server

这个服务器提供了一些工具，供 AI 助手与 Eventbrite API 交互，允许用户搜索活动、获取活动详情、检索场地信息以及列出活动类别。

Tools

search_events

Search for Eventbrite events based on various criteria

get_event

Get detailed information about a specific Eventbrite event

get_categories

Get a list of Eventbrite event categories

get_venue

Get information about a specific Eventbrite venue

README

Eventbrite MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，提供与 Eventbrite API 交互的工具。它允许 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，它提供了一个 Web 界面来测试 MCP 服务器。 Inspector 将在 http://localhost:5173 上可用。

手动运行

您可以使用以下命令手动运行 MCP 服务器：

npx -y supergateway --port 1337 --stdio "./build/index.js"

或者直接使用提供的运行脚本：

./run.sh

测试

# 运行所有测试
npm test

# 在监视模式下运行测试
npm run test:watch

# 运行带有覆盖率的测试
npm run test:coverage

# 运行集成测试
npm run test:integration

# 直接测试 API
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 个）