MCP 服务器

Eventbrite MCP Server

This is a Model Context Protocol (MCP) server that provides tools for interacting with the Eventbrite API. It allows AI assistants to search for events, get event details, retrieve venue information, and more.

README

Eventbrite MCP Server

Features

Search for events based on various criteria (location, date, category, etc.)
Get detailed information about specific events
Retrieve venue information
Get a list of event categories

Installation

From NPM

npm install -g @ibraheem4/eventbrite-mcp

From Source

Clone this repository
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Development

Running in Development Mode

npm run dev

This will watch for changes in the source files, rebuild the project, and restart the server automatically.

Running the MCP Server

You can run the MCP server using the provided run script:

./run.sh

This will start the MCP server using supergateway.

Running with Inspector

To run the MCP server with the Inspector, you can use:

npm run inspector

This will start the Inspector, which provides a web interface for testing the MCP server. The Inspector will be available at http://localhost:5173.

Running Manually

You can run the MCP server manually using:

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

Or simply use the provided run script:

./run.sh

Testing

# 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

Configuration

To use this MCP server, you need to:

Obtain an Eventbrite API key from the Eventbrite Developer Portal
Set up your API key in one of the following ways:
- Create a .env file in the project root (copy from .env.example):
```
EVENTBRITE_API_KEY=your_eventbrite_api_key_here
```
- Or provide it as an environment variable:
```
export EVENTBRITE_API_KEY=your_eventbrite_api_key_here
```
- Or configure it in the MCP settings file (see below)
Test your API key:
```
./test-api-key.js
```
Configure the MCP server in your MCP settings file

For Claude Desktop App

Add the following to your ~/Library/Application Support/Claude/claude_desktop_config.json file (on macOS):

{
  "mcpServers": {
    "eventbrite": {
      "command": "npx",
      "args": ["-y", "@ibraheem4/eventbrite-mcp"],
      "env": {
        "EVENTBRITE_API_KEY": "your-eventbrite-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Claude Developer Environment

Add the following to your ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json file (on macOS):

{
  "mcpServers": {
    "eventbrite": {
      "command": "npx",
      "args": ["-y", "@ibraheem4/eventbrite-mcp"],
      "env": {
        "EVENTBRITE_API_KEY": "your-eventbrite-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Quick Start

If you've installed from source, you can use the provided run script:

./run.sh

This will build the project and start the MCP server.

Available Tools

search_events

Search for Eventbrite events based on various criteria.

Parameters:

query (string, optional): Search query for events
location (object, optional): Location to search around
- latitude (number, required): Latitude coordinate
- longitude (number, required): Longitude coordinate
- within (string, optional): Distance (e.g., '10km', '10mi')
categories (array of strings, optional): Category IDs to filter by
start_date (string, optional): Start date in ISO format (e.g., '2023-01-01T00:00:00Z')
end_date (string, optional): End date in ISO format (e.g., '2023-12-31T23:59:59Z')
price (string, optional): Filter by 'free' or 'paid' events
page (number, optional): Page number for pagination
page_size (number, optional): Number of results per page (max 100)