@access-mcp/events 0.2.0 → 0.3.1

package/README.md

@@ -1,242 +1,74 @@
 # ACCESS-CI Events MCP Server
 
-A Model Context Protocol server providing access to ACCESS-CI events data including workshops, webinars, and training sessions with comprehensive filtering capabilities.
+MCP server for ACCESS-CI events including workshops, webinars, and training sessions.
 
-## Features
+## Usage Examples
 
-### 🔧 Tools
-
-- **`get_events`** - Get ACCESS-CI events with comprehensive filtering
-- **`get_upcoming_events`** - Get upcoming events (today onward)
-- **`search_events`** - **Enhanced!** Search events using API's native full-text search across all content
-- **`get_events_by_tag`** - Get events filtered by specific tags
-
-### 📊 Resources
-
-- **`accessci://events`** - All events data
-- **`accessci://events/upcoming`** - Upcoming events only
-- **`accessci://events/workshops`** - Workshop events only
-- **`accessci://events/webinars`** - Webinar events only
-
-## Installation
-
-```bash
-npm install -g @access-mcp/events
+### Search & Discovery
 ```
-
-## Usage
-
-### Claude Desktop Configuration
-
-Add to your Claude Desktop configuration:
-
-```json
-{
-  "mcpServers": {
-    "access-events": {
-      "command": "npx",
-      "args": ["@access-mcp/events"]
-    }
-  }
-}
+"Upcoming ACCESS events"
+"Python workshops"
+"Machine learning training"
+"Office hours this week"
 ```
 
-### Example Queries
-
-**Get upcoming events:**
-
-```
-What events are coming up in the next week?
-```
-
-**Search for specific topics (now much more powerful!):**
-
-```
-Find upcoming Python workshops
-Show me machine learning events
-Search for "office hours" this week
-```
-
-**Filter by skill level:**
-
+### Filtering
 ```
-Show me beginner-level events this month
+"Beginner events this month"
+"GPU computing workshops"
+"Advanced training sessions"
 ```
 
-**Get events by tags:**
-
-```
-Find all GPU computing events
-```
-
-## Key Improvements
-
-### 🚀 Enhanced Search (v2.1)
-
-**Native API Full-Text Search:**
-- Searches across titles, descriptions, speakers, tags, location, and event type
-- Supports multi-word queries (e.g., "machine learning", "office hours")
-- Much more comprehensive results than previous tag-only filtering
-- Server-side indexing for better performance
-
-**Search Examples:**
-- `"python"` - Find Python programming events
-- `"machine learning"` - Find ML-related content in any field
-- `"gpu computing"` - Find GPU-related events
-- `"office hours"` - Find all office hours sessions
-
-### 🌍 Timezone Support (v2.1)
-
-**Smart Timezone Handling:**
-- All timestamps returned in UTC (ISO 8601 format with Z suffix)
-- Timezone parameter controls relative date calculations
-- Common timezone examples: `America/New_York`, `Europe/London`, `Asia/Tokyo`
-- Default: UTC calculations
-
-## Filtering Capabilities
+## Tools
 
-### Date Filtering
+### `search_events`
 
-**Relative Dates (Dynamic):**
+Search and filter ACCESS-CI events.
 
-- `today` - Current date
-- `+1week`, `+2week` - Future weeks
-- `+1month`, `+2month` - Future months
-- `+1year` - Future year
-- `-1week`, `-1month` - Past periods
+**Parameters:**
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `query` | string | Search titles, descriptions, speakers, tags |
+| `type` | string | Filter: `workshop`, `webinar`, `training` |
+| `tags` | string | Filter: `python`, `gpu`, `hpc`, `ml` |
+| `date` | enum | Time period: `today`, `upcoming`, `past`, `this_week`, `this_month` |
+| `skill` | enum | Skill level: `beginner`, `intermediate`, `advanced` |
+| `limit` | number | Max results (default: 50) |
 
-**Absolute Dates (Fixed):**
+**Examples:**
+```javascript
+// Upcoming Python events
+search_events({ query: "python", date: "upcoming", limit: 10 })
 
-- `YYYY-MM-DD` format (e.g., "2024-08-30")
-- `YYYY-MM-DD HH:MM:SS` format with time
+// Machine learning workshops this month
+search_events({ query: "machine learning", date: "this_month", type: "workshop" })
 
-**Mixed Filtering:**
-You can combine relative and absolute dates in the same query.
-
-### Faceted Search Filters
-
-- **Event Type:** workshop, webinar, etc.
-- **Event Affiliation:** Community, ACCESS, etc.
-- **Skill Level:** beginner, intermediate, advanced
-- **Event Tags:** python, big-data, machine-learning, gpu, etc.
-
-## API Details
-
-### Event Object Structure
-
-Each event contains:
-
-- `id` - Unique identifier
-- `title` - Event title
-- `description` - Event description
-- `date` - Start date/time (ISO 8601)
-- `date_1` - End date/time (ISO 8601)
-- `location` - Event location
-- `event_type` - Type of event
-- `event_affiliation` - Organizational affiliation
-- `custom_event_tags` - Comma-separated tags
-- `skill_level` - Required skill level
-- `speakers` - Event speakers
-- `contact` - Contact information
-- `registration` - Registration URL/info
-- `created` - Creation timestamp
-- `changed` - Last modified timestamp
-
-### Enhanced Fields
-
-The server adds these computed fields:
-
-- `start_date` - Parsed start date object
-- `end_date` - Parsed end date object
-- `tags` - Tags split into array
-- `duration_hours` - Calculated event duration
-- `starts_in_hours` - Hours until event starts
-
-## Examples
-
-### Get Events with Multiple Filters
-
-```typescript
-// Get Python workshops for beginners in the next month
-{
-  "tool": "get_events",
-  "arguments": {
-    "beginning_date_relative": "today",
-    "end_date_relative": "+1month",
-    "event_type": "workshop",
-    "skill_level": "beginner",
-    "event_tags": "python"
-  }
-}
+// Beginner GPU training
+search_events({ tags: "gpu", skill: "beginner", date: "upcoming" })
 ```
 
-### Search Events (Enhanced API Search)
-
-```typescript
-// Search for GPU-related events using native API search
-{
-  "tool": "search_events",
-  "arguments": {
-    "query": "GPU computing",
-    "beginning_date_relative": "today",
-    "timezone": "America/New_York",
-    "limit": 10
-  }
-}
+## Installation
 
-// Multi-word search examples
-{
-  "tool": "search_events",
-  "arguments": {
-    "query": "machine learning",
-    "beginning_date_relative": "-1month"
-  }
-}
+```bash
+npm install -g @access-mcp/events
 ```
 
-### Get Events by Tag
+## Configuration
 
-```typescript
-// Get all machine learning events this month
+```json
 {
-  "tool": "get_events_by_tag",
-  "arguments": {
-    "tag": "machine-learning",
-    "time_range": "this_month",
-    "limit": 20
+  "mcpServers": {
+    "access-events": {
+      "command": "npx",
+      "args": ["@access-mcp/events"]
+    }
   }
 }
 ```
 
-## Development
-
-```bash
-# Build the server
-npm run build
-
-# Run in development
-npm run dev
-
-# Test the server
-npm test
-```
-
-## Base URL
-
-The server connects to: `https://support.access-ci.org/api/2.1/events` (v2.1 with UTC timestamps and enhanced search)
-
-## Technical Notes
-
-### API Version 2.1 Features
-- **UTC timestamps**: All dates returned in UTC with Z suffix (e.g., `2024-08-30T13:00:00Z`)
-- **Native search**: Uses `search_api_fulltext` parameter for comprehensive searching
-- **Timezone support**: Relative dates calculated using specified timezone
-- **Enhanced metadata**: Responses include API version and timezone info
+## Resources
 
-### General
-- All date comparisons use the event's start date (`date` field)
-- Results include both upcoming and past events unless date filtered
-- Faceted search filters use AND logic when combined
-- Response times are typically under 5 seconds
-- No pagination - all matching events are returned
-- URL encoding is handled automatically for special characters
+- `accessci://events` - All events data
+- `accessci://events/upcoming` - Upcoming events
+- `accessci://events/workshops` - Workshop events
+- `accessci://events/webinars` - Webinar events

package/dist/index.js

@@ -2,7 +2,8 @@
 import { EventsServer } from "./server.js";
 async function main() {
     const server = new EventsServer();
-    await server.start();
+    const port = process.env.PORT ? parseInt(process.env.PORT, 10) : undefined;
+    await server.start(port ? { httpPort: port } : undefined);
 }
 if (import.meta.url === `file://${process.argv[1]}`) {
     main().catch((error) => {

package/dist/server.d.ts

@@ -1,204 +1,31 @@
-import { BaseAccessServer } from "@access-mcp/shared";
+import { BaseAccessServer, Tool, Resource, CallToolResult } from "@access-mcp/shared";
+import { CallToolRequest, ReadResourceRequest, ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
 import { AxiosInstance } from "axios";
 export declare class EventsServer extends BaseAccessServer {
     private _eventsHttpClient?;
+    private drupalAuth?;
     constructor();
+    /**
+     * Get or create the Drupal auth provider for authenticated operations.
+     * Requires DRUPAL_API_URL, DRUPAL_USERNAME, and DRUPAL_PASSWORD env vars.
+     */
+    private getDrupalAuth;
+    /**
+     * Get the acting user's ACCESS ID for filtering.
+     */
+    private getActingUserAccessId;
     protected get httpClient(): AxiosInstance;
-    protected getTools(): ({
-        name: string;
-        description: string;
-        inputSchema: {
-            type: string;
-            properties: {
-                beginning_date_relative: {
-                    type: string;
-                    description: string;
-                    enum: string[];
-                    default?: undefined;
-                };
-                end_date_relative: {
-                    type: string;
-                    description: string;
-                    enum: string[];
-                };
-                beginning_date: {
-                    type: string;
-                    description: string;
-                };
-                end_date: {
-                    type: string;
-                    description: string;
-                };
-                timezone: {
-                    type: string;
-                    description: string;
-                    default: string;
-                };
-                event_type: {
-                    type: string;
-                    description: string;
-                };
-                event_affiliation: {
-                    type: string;
-                    description: string;
-                };
-                skill_level: {
-                    type: string;
-                    description: string;
-                    enum: string[];
-                };
-                event_tags: {
-                    type: string;
-                    description: string;
-                };
-                limit: {
-                    type: string;
-                    description: string;
-                    minimum: number;
-                    maximum: number;
-                };
-                query?: undefined;
-                tag?: undefined;
-                time_range?: undefined;
-            };
-            required: never[];
-        };
-    } | {
-        name: string;
-        description: string;
-        inputSchema: {
-            type: string;
-            properties: {
-                limit: {
-                    type: string;
-                    description: string;
-                    minimum: number;
-                    maximum: number;
-                };
-                event_type: {
-                    type: string;
-                    description: string;
-                };
-                timezone: {
-                    type: string;
-                    description: string;
-                    default: string;
-                };
-                beginning_date_relative?: undefined;
-                end_date_relative?: undefined;
-                beginning_date?: undefined;
-                end_date?: undefined;
-                event_affiliation?: undefined;
-                skill_level?: undefined;
-                event_tags?: undefined;
-                query?: undefined;
-                tag?: undefined;
-                time_range?: undefined;
-            };
-            required: never[];
-        };
-    } | {
-        name: string;
-        description: string;
-        inputSchema: {
-            type: string;
-            properties: {
-                query: {
-                    type: string;
-                    description: string;
-                };
-                beginning_date_relative: {
-                    type: string;
-                    description: string;
-                    default: string;
-                    enum?: undefined;
-                };
-                timezone: {
-                    type: string;
-                    description: string;
-                    default: string;
-                };
-                limit: {
-                    type: string;
-                    description: string;
-                    minimum: number;
-                    maximum: number;
-                };
-                end_date_relative?: undefined;
-                beginning_date?: undefined;
-                end_date?: undefined;
-                event_type?: undefined;
-                event_affiliation?: undefined;
-                skill_level?: undefined;
-                event_tags?: undefined;
-                tag?: undefined;
-                time_range?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        inputSchema: {
-            type: string;
-            properties: {
-                tag: {
-                    type: string;
-                    description: string;
-                };
-                time_range: {
-                    type: string;
-                    description: string;
-                    enum: string[];
-                    default: string;
-                };
-                timezone: {
-                    type: string;
-                    description: string;
-                    default: string;
-                };
-                limit: {
-                    type: string;
-                    description: string;
-                    minimum: number;
-                    maximum: number;
-                };
-                beginning_date_relative?: undefined;
-                end_date_relative?: undefined;
-                beginning_date?: undefined;
-                end_date?: undefined;
-                event_type?: undefined;
-                event_affiliation?: undefined;
-                skill_level?: undefined;
-                event_tags?: undefined;
-                query?: undefined;
-            };
-            required: string[];
-        };
-    })[];
-    protected getResources(): {
-        uri: string;
-        name: string;
-        description: string;
-        mimeType: string;
-    }[];
-    handleToolCall(request: any): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleResourceRead(request: any): Promise<{
-        contents: {
-            uri: any;
-            mimeType: string;
-            text: string;
-        }[];
-    }>;
+    protected getTools(): Tool[];
+    protected getResources(): Resource[];
+    protected handleToolCall(request: CallToolRequest): Promise<CallToolResult>;
+    protected handleResourceRead(request: ReadResourceRequest): Promise<ReadResourceResult>;
     private buildEventsUrl;
     private getEvents;
-    private getUpcomingEvents;
     private searchEvents;
-    private getEventsByTag;
-    private getPopularTags;
+    /**
+     * Get events for the authenticated user via the unified Drupal view.
+     * Uses the /jsonapi/views/event_instance_mine/my_events_page endpoint
+     * which filters by X-Acting-User header.
+     */
+    private getMyEvents;
 }