karishmadaga/events-ai

AI-Powered Event Search MCP Server

An intelligent event search and analysis MCP (Model Context Protocol) server powered by Claude AI. This server provides natural language event search capabilities and data analysis for event databases.

Features

• AI-Powered Search: Use natural language queries to find relevant events
• Event Analysis: Get insights, statistics, and recommendations about event data
• Claude Integration: Powered by Anthropic's Claude AI for intelligent understanding
• MCP Compatible: Works seamlessly with Claude Desktop and other MCP clients

Installation

1. Clone the repository:

git clone <repository-url>
cd events-ai

2. Install dependencies:

npm install

3. Set up your environment:

cp .env.example .env
# Add your Anthropic API key to .env

4. Build the project:

npm run build

Configuration

Environment Variables

Create a .env file with your Anthropic API key:

ANTHROPIC_API_KEY=your_anthropic_api_key_here

Get your API key from https://console.anthropic.com/

Claude Desktop Configuration

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "events-ai": {
      "command": "node",
      "args": ["/absolute/path/to/events-ai/build/index.js"]
    }
  }
}

Usage

Available Tools

1. ai_search_events: Natural language event search

   • Example: "Find outdoor events under $50"
   • Example: "Tech conferences with AI focus"

2. ai_analyze_events: Event data analysis

   • Example: "What are the most popular event categories?"
   • Example: "Show price trends by category"

3. get_raw_events_data: Access raw JSON event data

Example Queries

• "Find me some fun outdoor activities for this weekend"
• "I'm looking for professional networking events under $100"
• "Show me free family-friendly events"
• "What tech conferences are happening in September?"
• "Analyze the price distribution of all events"
• "Recommend events for someone interested in technology"

Development

Scripts

• npm run build - Compile TypeScript
• npm start - Run the compiled server
• npm run dev - Run TypeScript in watch mode

Project Structure

events-ai/
├── src/
│   └── index.ts          # Main MCP server implementation
├── data/
│   └── events.json       # Event database
├── build/                # Compiled JavaScript (gitignored)
├── package.json
├── tsconfig.json
└── .env                  # Environment variables (gitignored)

Event Data Format

Events should follow this JSON structure:

{
  "events": [
    {
      "id": "unique_id",
      "title": "Event Title",
      "date": "2024-08-17",
      "day": "Sunday",
      "cost": "free",
      "type": "category/type",
      "location": "Location Name",
      "category": "specific/category"
    }
  ]
}

Requirements

• Node.js 16+
• TypeScript 5+
• Anthropic API key
• Claude Desktop (for MCP integration)

License

ISC

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Support

For issues and questions, please open an issue on GitHub.