Network School Events MCP Server

# Network School Events MCP Server A Model Context Protocol (MCP) server that provides access to Network School Luma calendar events through Claude Desktop. ## Features ### Tools - **get_todays_events**: Fetch all events happening today - **get_upcoming_events**: Get events in the next N days (default: 7) - **search_events**: Search events by name or description - **register_for_event**: Register for events directly with your name and email ### Wiki Resources - **Access Network School wiki pages** with information about: - Visas (Malaysia, Singapore, travel from different countries) - Internet (WiFi passwords, SIM cards) - Getting Started guide - And more - easily add new wiki pages as markdown files! ## Installation ```bash npm install ``` ## Build ```bash npm run build ``` ## Development Watch mode for development: ```bash npm run dev ``` ## Testing Test the API connection and event formatting: ```bash npm test ``` This will fetch events from the Luma API and display them in the formatted output. ## Configuration Add to your Claude Desktop config file: **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "network-school-events": { "command": "node", "args": ["/Users/akashkumar/Code/ns-mcp/build/index.js"] } } } ``` You can also copy the configuration from `claude_config_example.json` in this project. ## Usage in Claude Desktop After configuration, restart Claude Desktop. The server will automatically connect when Claude starts. You can then ask Claude questions like: **Viewing Events:** - "What events are happening today at Network School?" - "Show me upcoming events in the next 14 days" - "Show me events in the next 30 days" - "Search for hackathon events" - "Find events about AI or machine learning" - "Are there any coding events coming up?" **Registering for Events:** - "Register me for the Vibecoding event with name John Doe and email john@example.com" - "Sign me up for event evt-XXX with my name and email" - After viewing events, you can say: "Register me for that AI Music Lab event" **Accessing Wiki Information:** - "How do I get a visa for Malaysia from India?" - "What's the WiFi password?" - "How do I get started at Network School?" - "What are the visa requirements for Singapore?" - Claude will automatically access the relevant wiki pages to answer your questions! ### Available Tools 1. **get_todays_events**: Returns all events happening today 2. **get_upcoming_events**: Returns events in the next N days (default: 7) - Parameter: `days` (optional, number) 3. **search_events**: Searches events by name or description - Parameter: `query` (required, string) 4. **register_for_event**: Register for an event - Parameters: - `event_id` (required, string): Event API ID from the event listing - `name` (required, string): Your full name - `email` (required, string): Your email address - `phone_number` (optional, string): Your phone number - `timezone` (optional, string): Your timezone (default: Asia/Kuala_Lumpur) ## API This server fetches data from the public Network School Luma calendar API. No authentication is required. ## Adding Wiki Content To add or update wiki pages: 1. Create a new `.md` file in the `wiki/` directory: ```bash echo "# My New Page" > wiki/my-new-page.md ``` 2. Add your content in Markdown format 3. Rebuild the server: ```bash npm run build ``` 4. Restart Claude Desktop The new wiki page will automatically be available as a resource that Claude can access! **Tips:** - Use descriptive filenames (e.g., `transportation.md`, `food-guide.md`) - Include headers with `#` for better organization - Link to other resources or external URLs - Keep information up-to-date ## Tech Stack - TypeScript - Node.js - @modelcontextprotocol/sdk - axios for HTTP requests - date-fns for date formatting ## License MIT