Luma Events MCP Server

A Model Context Protocol (MCP) server that provides access to tech events from Luma. Built with mcp-lite and deployed on Cloudflare Workers.

Features

🎯 Search Tech Events: Discover upcoming tech events, conferences, and meetups
🚀 Serverless: Runs on Cloudflare's global edge network
⚡ Fast: Built with mcp-lite for minimal overhead
🔧 MCP Compatible: Works with any MCP client (Claude Desktop, etc.)

Prerequisites

Before you begin, make sure you have:

Node.js 18+ installed
pnpm package manager (or npm/yarn)
Cloudflare account (free tier works fine)
Wrangler CLI (installed automatically with dependencies)

Installation

1. Clone or Navigate to Project

cd mv-mcp-lite

2. Install Dependencies

pnpm install

This will install:

mcp-lite - MCP server framework
hono - Web framework for Cloudflare Workers
axios - HTTP client for API requests
zod - Schema validation
wrangler - Cloudflare Workers CLI

3. Set Up Authentication (Optional)

If you need to authenticate with Cloudflare:

pnpm wrangler login

This will open a browser window to authorize Wrangler with your Cloudflare account.

Local Development

Start Development Server

pnpm dev

This starts a local Cloudflare Workers development server at http://localhost:8787.

Test the Server

Health Check: Visit http://localhost:8787/ in your browser
- Should display: "Luma MCP Server (Apify) – connect via /mcp"
MCP Endpoint: The MCP server is available at http://localhost:8787/mcp

Configure MCP Client

To use this server with an MCP client like Claude Desktop, add this to your MCP configuration file:

macOS/Linux: ~/.cursor/mcp.json or ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "luma-events": { "url": "http://localhost:8787/mcp", "transport": "http" } } }

Note: For local development, use localhost:8787. After deployment, replace with your Cloudflare Workers URL.

Deployment to Cloudflare

1. Deploy to Cloudflare Workers

pnpm deploy

This command:

Bundles your code
Minifies for production
Deploys to Cloudflare's global network
Provides you with a live URL (e.g., https://luma-events-mcp.your-subdomain.workers.dev)

2. Get Your Deployment URL

After deployment, Wrangler will display your Worker's URL:

Published luma-events-mcp (X.XX sec) https://luma-events-mcp.your-subdomain.workers.dev

3. Update MCP Client Configuration

Update your MCP configuration to use the production URL:

{ "mcpServers": { "luma-events": { "url": "https://luma-events-mcp.your-subdomain.workers.dev/mcp", "transport": "http" } } }

4. Restart Your MCP Client

Restart Claude Desktop or your MCP client to connect to the deployed server.

Usage

Once configured, you can use the following tool through your MCP client:

Available Tools

`search_luma_events`

Searches for tech events on Luma.

Parameters:

city (optional): City name (currently not implemented in filtering)
country (optional): Country name (currently not implemented in filtering)
query (optional): Search keyword or topic (e.g., "hackathon", "AI", "web3")

Example prompts in Claude:

"Find tech events on Luma"
"Search for AI events on Luma"
"Show me upcoming hackathons from Luma"
"What tech events are happening soon?"

Example Response: The tool returns a JSON array of events with details like:

Event name and description
Date and time
Location (physical or virtual)
Number of attendees
Registration link
Host information

Configuration

Environment Variables

For local development, create a .dev.vars file in the project root:

# .dev.vars (for local development only) # Add any API keys or secrets here # EXAMPLE_API_KEY=your-key-here

For production secrets:

# Set production secrets pnpm wrangler secret put EXAMPLE_API_KEY

Wrangler Configuration

Edit wrangler.jsonc to customize:

{ "$schema": "node_modules/wrangler/config-schema.json", "name": "luma-events-mcp", // Worker name "main": "src/index.ts", // Entry point "compatibility_date": "2025-10-07" // Cloudflare compatibility date }

Project Structure

mv-mcp-lite/ ├── src/ │ └── index.ts # Main MCP server code ├── package.json # Dependencies and scripts ├── wrangler.jsonc # Cloudflare Workers config ├── tsconfig.json # TypeScript configuration ├── .dev.vars # Local environment variables (gitignored) └── README.md # This file

Development

Available Scripts

# Start local development server pnpm dev # Deploy to Cloudflare Workers pnpm deploy # Generate TypeScript types for Cloudflare bindings pnpm cf-typegen

Adding New Tools

To add new MCP tools, edit src/index.ts:

mcp.tool("your_tool_name", { description: "What your tool does", inputSchema: z.object({ param1: z.string().describe("Description"), param2: z.number().optional(), }), handler: async (args) => { // Your tool logic here return { content: [ { type: "text", text: "Your response", }, ], }; }, });

Adding Resources

Resources provide URI-identified content:

mcp.resource( "events://upcoming", { name: "Upcoming Events", description: "List of upcoming tech events", mimeType: "application/json", }, async (uri) => ({ contents: [ { uri: uri.href, type: "text", text: JSON.stringify({ events: [] }), mimeType: "application/json", }, ], }) );

Troubleshooting

Issue: "Module not found" errors

Solution: Make sure dependencies are installed:

pnpm install

Issue: Wrangler login fails

Solution: Try logging in with a different method:

pnpm wrangler login --browser=false

Issue: Deployment fails

Solution: Check your Cloudflare account limits and verify authentication:

pnpm wrangler whoami

Issue: MCP client can't connect

Solution:

Verify the URL is correct (include /mcp path)
Check if the server is running (visit the URL in browser)
Restart your MCP client after configuration changes
Check MCP client logs for connection errors

Issue: CORS errors

Solution: If accessing from a web client, add CORS middleware to src/index.ts:

import { cors } from "hono/cors"; app.use( "/mcp", cors({ origin: ["https://your-client-domain.com"], credentials: true, }) );

Technical Details

Built With

mcp-lite: Lightweight MCP server framework
Hono: Fast web framework for edge computing
Cloudflare Workers: Serverless execution environment
Zod: TypeScript-first schema validation

Architecture

┌─────────────────┐ │ MCP Client │ │ (Claude, etc.) │ └────────┬────────┘ │ HTTP/SSE ▼ ┌─────────────────┐ │ Cloudflare │ │ Workers │ │ (Edge Runtime) │ └────────┬────────┘ │ ▼ ┌─────────────────┐ │ mcp-lite │ │ McpServer │ └────────┬────────┘ │ ▼ ┌─────────────────┐ │ Luma API │ │ (lu.ma/tech) │ └─────────────────┘

Resources

mcp-lite Documentation: https://github.com/fiberplane/mcp-lite
Model Context Protocol: https://modelcontextprotocol.io/
Cloudflare Workers Docs: https://developers.cloudflare.com/workers/
Luma Platform: https://lu.ma

License

[Add your license here]

Contributing

Contributions welcome! Please feel free to submit a Pull Request.

Support

For issues and questions:

Check the Troubleshooting section
Review mcp-lite examples
Open an issue in this repository

Built with ❤️ using mcp-lite

Luma Events MCP Server

Features

Prerequisites

Installation

1. Clone or Navigate to Project

2. Install Dependencies

3. Set Up Authentication (Optional)

Local Development

Start Development Server

Test the Server

Configure MCP Client

Deployment to Cloudflare

1. Deploy to Cloudflare Workers

2. Get Your Deployment URL

3. Update MCP Client Configuration

4. Restart Your MCP Client

Usage

Available Tools

search_luma_events

Configuration

Environment Variables

Wrangler Configuration

Project Structure

Development

Available Scripts

Adding New Tools

Adding Resources

Troubleshooting

Issue: "Module not found" errors

Issue: Wrangler login fails

Issue: Deployment fails

Issue: MCP client can't connect

Issue: CORS errors

Technical Details

Built With

Architecture

Resources

License

Contributing

Support

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

`search_luma_events`