MCP 服务器

SeatGeek MCP Server

Enables users to search for events, performers, and venues through the SeatGeek API. Provides event recommendations, detailed venue seating information, and performer discovery capabilities for ticketed entertainment events.

README

seatgeek-mcp

Comprehensive MCP server exposing a registry of SeatGeek tools including events, performers, venues, section info, and recommendations as a TypeScript library.

Demo

seatgeek-mcp-demo

Prerequisites

Node.js >= 18.0.0
npm >= 8.0.0

Installation

npm install seatgeek-mcp

Usage

As a Standalone Server

# STDIO transport (default)
npm start

# HTTP streaming transport
MCP_HTTP=1 PORT=8080 npm start

Tools

find_events: Search for events by performer, location, date, or venue. This tool is optimized for finding specific events based on user queries. If the query involves a performer, it first looks up the performer, then finds events for that performer. Otherwise, it searches events directly. Returns structured event data with venue information.
find_event_recommendations: Get personalized event recommendations based on performers, events, or location. This tool first searches for performers and/or events based on the query, then uses the IDs to find similar events. Use location parameters for nearby events.
find_performer_recommendations: Get personalized performer recommendations based on performers, events, or location. This tool first searches for performers and/or events based on the queries, then uses the IDs to find similar performers.
retrieve_event_venue_information: Get detailed seating information including sections and rows for a specific event. This tool first searches for the event using the provided query, then retrieves detailed venue layout information.

Environment Variables

SEATGEEK_CLIENT_ID: Your SeatGeek API client ID (required)
SEATGEEK_SECRET: Your SeatGeek API secret (optional)
MCP_HTTP: Set to any value to enable HTTP transport instead of STDIO
PORT: Port to listen on when using HTTP transport (default: 8080)

Setting up Environment Variables

To use this MCP server, you need to set up a .env file in the root directory with your SeatGeek API credentials:

Copy the .env.example file to .env:
```
cp .env.example .env
```
Edit the .env file and replace the placeholder values with your actual SeatGeek API credentials

You can obtain your SeatGeek API credentials by creating an account at SeatGeek Platform.

Development

Setup

npm install

Build

npm run build

Development Server

npm run dev

Clean Build

npm run clean

Testing the Server

You can test the server in several ways:

Using HTTP transport (easiest for testing):
```
MCP_HTTP=1 PORT=8080 npm start
```

Using curl to test tools (proper MCP protocol sequence):

The MCP protocol requires a specific sequence of requests with proper headers:

a. Initialize the connection (required first step):

curl -v -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-06-11", "capabilities": {}, "clientInfo": {"name": "curl", "version": "1.0.0"}}}'

b. Extract the session ID from the response headers (look for mcp-session-id)

c. Use the session ID for subsequent requests:

# List available tools
curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: YOUR_SESSION_ID_HERE" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

# Call a specific tool (example)
curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: YOUR_SESSION_ID_HERE" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "find_events", "arguments": {"q": "concert", "per_page": 5}}}'

For a complete working example, see:

examples/curl-example.sh - Shell script demonstrating the full sequence of requests
examples/node-example.js - Node.js script showing programmatic usage

Using the test scripts:

# Run the simple test server script
npm run test-server

# Run the comprehensive tool tests (requires server to be running separately)
npm run test-tools

The server implements the Model Context Protocol (MCP) specification, so it can be used with any MCP-compatible client.

Using with Claude Desktop

Prerequisites

Installed Claude Desktop
Added claude_desktop_config.json under Settings -> Developer

Setup Instructions

Add to mcpServers list:

"seatgeek-mcp": {
   "command": "node",
   "args": ["/path-to/seatgeek-mcp/dist/server.js"],
   "env": {
      "SEATGEEK_CLIENT_ID": "your-client-id"
   }
}

Using with OpenWebUI

You can use this MCP server with OpenWebUI through the mcpo (MCP Over HTTP) proxy, which automatically generates OpenAPI documentation from your MCP tool schemas.

Prerequisites

Docker installed on your system (Optional if using uv)
OpenWebUI installed and running

Setup Instructions

Start the mcpo proxy:

docker run -p 8000:8000 -v $(pwd):/workspace -w /workspace ghcr.io/open-webui/mcpo:main -- npm start

uvx mcpo --port 8000 -- npm start

Verify the proxy is running:
- Open your browser and navigate to http://localhost:8000/docs to see the automatically generated Swagger UI documentation
- You can also check the OpenAPI specification at http://localhost:8000/openapi.json
Connect to OpenWebUI:
- Open OpenWebUI
- Go to Settings > Tools & Integrations
- Add a new OpenAPI-compatible tool
- Use the URL: http://localhost:8000

Example Usage in OpenWebUI

Once connected, you can use these tools in OpenWebUI that will make requests such as:

To search for performers: {"q": "washington nationals", "per_page": 5}
To search for venues: {"city": "New York", "per_page": 5}

The mcpo proxy automatically handles the conversion between the OpenAPI REST interface and the MCP protocol, making your MCP tools accessible through standard REST endpoints that OpenWebUI can easily integrate with.