Nordic Thingy:52 MCP Server

# 🎯 Nordic Thingy MCP Server - Comprehensive Prompt Guide ## 📚 Table of Contents - [Quick Start Prompts](#quick-start-prompts) - [Basic Operations](#basic-operations) - [Creative Use Cases](#creative-use-cases) - [Advanced Automation](#advanced-automation) - [Debugging & Troubleshooting](#debugging--troubleshooting) - [Community Examples](#community-examples) --- ## 🚀 Quick Start Prompts ### First Time Setup ``` "Find my Nordic Thingy device and connect to it" ``` What Claude will do: 1. Scan for nearby Thingy devices 2. Show you available devices 3. Connect to the one you select ### Basic Connection ``` "Connect to my Thingy at address XX:XX:XX:XX:XX:XX" ``` ### Check Status ``` "Is my Thingy connected? What's its status?" ``` --- ## 🎮 Basic Operations ### 💡 LED Control **Simple Colors:** ``` "Turn the Thingy LED red" "Make the LED blue" "Set the LED to green" ``` **Custom Colors:** ``` "Set the Thingy LED to RGB(255, 100, 50)" "Make the LED purple" "Change the LED to a warm orange color" ``` **Turn Off:** ``` "Turn off the Thingy LED" "Switch off the light" ``` ### 🔊 Sound Control **Play Sounds:** ``` "Play sound 1 on my Thingy" "Make the Thingy beep" "Play a notification sound" "Cycle through all available sounds" ``` **Use as Feedback:** ``` "Beep twice to confirm" "Play sound 3 when temperature exceeds 25°C" ``` ### 📊 Sensor Reading **Read All Sensors:** ``` "What are the current sensor readings from my Thingy?" "Check the temperature, humidity, and air quality" "Give me all environmental data" ``` **Specific Sensors:** ``` "What's the temperature?" "Check the CO2 level" "Is the air quality good?" "What's the humidity right now?" ``` **Continuous Monitoring:** ``` "Monitor the temperature and alert me if it goes above 25°C" "Watch the CO2 levels and let me know if they're unhealthy" ``` --- ## 🎨 Creative Use Cases ### 🌈 Mood Lighting ``` "Create a relaxing atmosphere - set the LED to a calming blue" ``` ``` "Make a rainbow effect by cycling through colors: red, orange, yellow, green, blue, purple" ``` ``` "Set up party mode - alternate between bright colors with beeps" ``` ### 🏠 Smart Home Integration **Temperature Monitoring:** ``` "Check if my room is too hot (>25°C) and turn the LED red if so, otherwise green" ``` **Air Quality Alerts:** ``` "Monitor CO2 levels every minute. If above 1000 ppm, set LED to red and beep" ``` **Presence Detection:** ``` "Flash the LED blue and beep when you detect motion or temperature change" ``` ### 🎮 Interactive Applications **Status Indicators:** ``` "Create a traffic light system: - Green LED when air quality is good - Yellow when moderate - Red when poor" ``` **Notification System:** ``` "When I say 'notify me', make the Thingy: 1. Beep twice 2. Flash red LED 3 times 3. Show current sensor data" ``` ### 📈 Data Analysis ``` "Read sensors every 30 seconds for 5 minutes and tell me: - Average temperature - Temperature trend (increasing/decreasing) - Air quality assessment" ``` ``` "Compare current room conditions to ideal office environment: - Temperature: 20-22°C - Humidity: 40-60% - CO2: <800 ppm" ``` --- ## 🔧 Advanced Automation ### Scripted Sequences **Morning Routine:** ``` "Create a morning routine: 1. Connect to Thingy 2. Check air quality 3. If CO2 >1000: flash red LED, suggest opening windows 4. Show temperature and humidity 5. Set LED to green if all is good" ``` **Health Check:** ``` "Perform a health check: 1. Scan for my Thingy 2. Try to connect 3. Read all sensors 4. Test LED (cycle R, G, B) 5. Test speaker (play sound 1) 6. Report any issues" ``` ### Conditional Actions ``` "Set up smart alerts: - If temperature >25°C: LED orange, play sound 2 - If CO2 >1000 ppm: LED red, play sound 5 - If humidity <30%: LED purple, play sound 3 - Otherwise: LED green" ``` ### Multi-Device Control ``` "If I have multiple Thingys: 1. Scan and list all devices 2. Connect to each one 3. Set them to different colors (rainbow effect) 4. Play sounds in sequence" ``` --- ## 🐛 Debugging & Troubleshooting ### Connection Issues ``` "My Thingy won't connect. Help me troubleshoot: 1. Scan for devices 2. Show signal strength 3. Attempt connection 4. If fails, explain possible causes" ``` ``` "Check if my Thingy is discoverable and nearby" ``` ### Sensor Verification ``` "Verify all sensors are working correctly by reading them 5 times and checking for consistent values" ``` ``` "Test each sensor individually and report any anomalies" ``` ### LED/Sound Testing ``` "Test all hardware: 1. Cycle through all 8 sounds 2. Test LED with primary colors (R, G, B) 3. Turn everything off 4. Confirm all features work" ``` --- ## 👥 Community Examples ### Example 1: Office Air Quality Monitor *Submitted by: Community* ``` "Create an office air quality monitor: 1. Read CO2 and TVOC every 2 minutes 2. Display status with LED: - Green: Good (<800 ppm) - Yellow: Moderate (800-1200 ppm) - Red: Poor (>1200 ppm) 3. Beep once when crossing thresholds 4. Provide summary every 30 minutes" ``` ### Example 2: Temperature Alert System *Submitted by: Community* ``` "Set up a temperature monitoring system: - Monitor every minute - If temperature rises above 26°C: * Flash red LED 3 times * Play alarm sound (sound 8) * Show current temp and humidity - If temperature drops below 18°C: * Flash blue LED 3 times * Play notification (sound 3)" ``` ### Example 3: Smart Plant Monitor *Submitted by: Community* ``` "Help me monitor my plants: 1. Check humidity every hour 2. If humidity <40%: remind me to water plants (red LED + beep) 3. Monitor temperature - plants prefer 20-24°C 4. Track CO2 levels (plants need good air circulation) 5. Keep daily log of readings" ``` ### Example 4: Meeting Room Status *Submitted by: Community* ``` "Create a meeting room status indicator: - Green LED: Room is free and comfortable - Yellow LED: Room is occupied or air quality degrading - Red LED: Room needs ventilation (high CO2) - Play sound when status changes" ``` ### Example 5: Study Session Timer *Submitted by: Community* ``` "Set up a Pomodoro timer with Thingy: 1. Start: Green LED 2. Work for 25 minutes 3. After 25min: Flash orange, play sound 1 4. Break (5 min): Blue LED 5. After 4 cycles: Long break (15 min): Purple LED, sound 5 6. Monitor air quality during sessions" ``` --- ## 💡 Tips for Effective Prompts ### Be Specific ✅ Good: "Set LED to RGB(255, 0, 0) when temperature exceeds 25°C" ❌ Vague: "Change the light when it gets hot" ### Chain Actions ✅ Good: "First scan for devices, then connect to the Thingy at XX:XX:XX:XX:XX:XX, then check sensors" ❌ Unclear: "Do stuff with my Thingy" ### Provide Context ✅ Good: "I'm monitoring my home office air quality during work hours (9-5). Alert me if CO2 goes above 1000 ppm" ❌ Limited: "Check CO2" ### Use Conditional Logic ✅ Good: "If temperature > 25°C AND humidity < 40%, set LED to orange and beep" ❌ Simple: "Check temperature and humidity" --- ## 🎯 Prompt Templates ### Template 1: Basic Control ``` "[Action] the [hardware component] to [specification]" Examples: - "Set the LED to red" - "Play sound 3 on the speaker" - "Turn off the LED" ``` ### Template 2: Sensor Query ``` "[Read/Check/Monitor] [sensor type] and [action based on result]" Examples: - "Read temperature and alert if above 25°C" - "Monitor CO2 levels every minute" - "Check all sensors and summarize" ``` ### Template 3: Conditional Automation ``` "If [condition], then [action], otherwise [alternative action]" Examples: - "If CO2 > 1000 ppm, set LED red and beep, otherwise set LED green" - "If temperature rises above 24°C, flash orange LED 3 times" ``` ### Template 4: Sequences ``` "[Create/Set up/Run] [sequence name]: 1. [Step 1] 2. [Step 2] 3. [Step 3] ..." Examples: - "Create startup sequence: 1) Connect 2) Test LED 3) Read sensors" - "Run morning check: 1) Check air quality 2) Display with LED 3) Report" ``` --- ## 📝 Contributing Your Prompts We encourage the community to share useful prompts! To contribute: 1. **Test your prompt** thoroughly 2. **Document the use case** clearly 3. **Share on GitHub** (create an issue or pull request) 4. **Include**: - Prompt text - Expected behavior - Use case description - Any special requirements Example contribution format: ```markdown ### [Your Prompt Name] **Use Case:** [Brief description] **Prompt:** ``` [Your prompt here] ``` **Expected Result:** [What should happen] **Requirements:** [Any specific setup needed] ``` --- ## 📊 Data Querying & Analysis ### Real-Time Data Queries **Simple Queries:** ``` "What's the current temperature reading from my Thingy?" "Show me the current CO2 level" "What's the humidity in my room right now?" ``` **Comparative Queries:** ``` "How does the current temperature compare to the optimal range of 20-22°C?" "Is the air quality better or worse than it was an hour ago?" "Compare today's average temperature to yesterday's" ``` **Multi-Sensor Queries:** ``` "Give me a complete environmental snapshot: - Temperature - Humidity - Air pressure - CO2 levels - TVOC levels - Light levels" ``` ### Historical Data Analysis **Trend Analysis:** ``` "Monitor temperature every 5 minutes for the next hour and show me: - Highest reading - Lowest reading - Average - Trend direction (rising/falling/stable)" ``` ``` "Track CO2 levels throughout my workday and tell me: - Peak times (when it's highest) - Average level - Percentage of time in healthy range (<800 ppm) - Recommendations for improvement" ``` **Pattern Recognition:** ``` "Analyze humidity patterns over the past 2 hours and tell me: - Is there a repeating pattern? - What might be causing fluctuations? - Should I take any action?" ``` ### Health & Comfort Queries **Environmental Health:** ``` "Assess my room's health score based on: - Temperature: Optimal 20-22°C (weight: 30%) - Humidity: Optimal 40-60% (weight: 25%) - CO2: Below 800 ppm (weight: 35%) - Air pressure: Stable (weight: 10%) Give me a score out of 100" ``` **Sleep Environment:** ``` "Is my bedroom environment optimal for sleep? Check: - Temperature: Should be 16-19°C - Humidity: 40-50% - CO2: Below 600 ppm - Recommend adjustments if needed" ``` **Work Productivity:** ``` "Evaluate my home office conditions for productivity: - Temperature comfort (20-22°C) - Air quality (CO2 < 800 ppm) - Humidity (40-60%) Tell me what's affecting my productivity and how to fix it" ``` ### Data Export & Logging **CSV Export:** ``` "Monitor all sensors every minute for 30 minutes and save the data as CSV: - Timestamp - Temperature - Humidity - CO2 - TVOC - Pressure Format it ready for Excel analysis" ``` **Summary Reports:** ``` "Create a daily environmental report: - Time period: Past 24 hours - Average, min, max for each sensor - Time spent in optimal ranges - Key insights and recommendations - Alert events (if any thresholds crossed)" ``` ### Predictive Queries **Forecast Questions:** ``` "Based on the temperature trend in the last 2 hours, when will it reach 25°C?" "If CO2 keeps rising at this rate, when should I open a window?" "Predict if I'll need to run the humidifier in the next hour" ``` ### Comparative Analysis **Room Comparison:** ``` "If I have multiple Thingys in different rooms: - Compare temperature across all rooms - Which room has the best air quality? - Which room should I work in right now? - Create a comfort ranking" ``` **Time-Based Comparison:** ``` "Compare current readings to: - Same time yesterday - Same time last week - Average for this time of day Highlight any significant changes" ``` ### Advanced Data Queries **Correlation Analysis:** ``` "Analyze the relationship between: - Temperature and humidity - CO2 levels and time of day - Occupancy (based on temp/CO2 changes) and air quality Show me any patterns or correlations" ``` **Anomaly Detection:** ``` "Monitor for unusual readings: - Sudden temperature spikes/drops (>2°C change) - CO2 rapid increases (>200 ppm/10min) - Humidity fluctuations outside normal range Alert me immediately if detected" ``` **Multi-Variable Analysis:** ``` "What factors are affecting my room's air quality right now? Analyze: - CO2 trends - Temperature changes - Humidity levels - Recent activity (based on sensor changes) - Ventilation effectiveness Give me actionable insights" ``` ### Statistical Queries **Statistical Summary:** ``` "Provide statistical analysis for the past hour: Temperature: - Mean, median, mode - Standard deviation - Range - 95th percentile CO2: - Mean, median - Peak value and time - Time above/below thresholds - Variance" ``` **Confidence Intervals:** ``` "Based on today's readings, what's the likely temperature range for: - Next hour (95% confidence) - Rest of the day - Similar conditions tomorrow" ``` ### Visualization Requests **Data Visualization:** ``` "Create a text-based graph showing: - Temperature trend over the last 2 hours - Use ASCII art or emojis - Mark optimal range - Highlight any concerning values" ``` ``` "Show me a dashboard view: ┌─────────────────────────┐ │ Room Health Dashboard │ ├─────────────────────────┤ │ 🌡️ Temp: 22°C ✓ │ │ 💧 Humid: 55% ✓ │ │ 🌫️ CO2: 750 ppm ✓ │ │ 💨 TVOC: Low ✓ │ │ 📊 Score: 92/100 🌟 │ └─────────────────────────┘" ``` ### Machine Learning Queries **Pattern Learning:** ``` "Learn my daily patterns: - When does temperature typically peak? - When is CO2 usually highest? - What's my room's typical 'signature'? Use this to predict problems before they occur" ``` **Behavioral Insights:** ``` "Based on sensor data, tell me: - When I'm usually in the room (occupancy patterns) - My preferred temperature range - How long it takes to ventilate the room - Optimal times to adjust environment" ``` --- ## 🔗 Additional Resources - **GitHub Repository:** [Link to repo] - **MCP Documentation:** https://docs.anthropic.com/mcp - **Nordic Thingy:52 Docs:** https://www.nordicsemi.com/Products/Development-hardware/Nordic-Thingy-52 - **Community Discord:** [Link if available] - **Issue Tracker:** [Link to issues] --- ## 🌟 Featured Community Projects ### Project: Smart Desk Monitor *Uses Thingy to monitor workspace conditions and optimize productivity* ### Project: Plant Care Assistant *Automated plant health monitoring with visual and audio alerts* ### Project: Home Lab Temperature Monitor *Server room monitoring with multi-Thingy setup* *[Add your project here by contributing!]* --- ## 📧 Get Help If you're stuck or have questions: 1. Check the troubleshooting section above 2. Search existing GitHub issues 3. Ask on Discord (if available) 4. Create a new issue with: - Your prompt - Expected vs actual behavior - Error messages (if any) - Your setup details --- **Happy Thingy Hacking! 🚀** *This guide is community-maintained. Contributions welcome!*