Nordic Thingy:52 MCP Server

# 🚀 Nordic Thingy MCP - Quick Start Guide Welcome! This guide will get you up and running with your Nordic Thingy:52 in 5 minutes. ## 📋 What You'll Need 1. **Nordic Thingy:52** (powered on and nearby) 2. **Claude Desktop** with MCP support 3. **Bluetooth** enabled on your computer ## ⚡ 5-Minute Setup ### Step 1: Install the MCP Server ```bash # Clone this repository git clone https://github.com/YOUR_USERNAME/nordic-thingy-mcp.git cd nordic-thingy-mcp # Install dependencies pip install -r requirements.txt ``` ### Step 2: Configure Claude Desktop Add this to your Claude Desktop config file: **Location:** - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` **Configuration:** ```json { "mcpServers": { "nordic-thingy": { "command": "python3", "args": [ "/FULL/PATH/TO/mcp_server_nordic_thingy.py" ] } } } ``` Replace `/FULL/PATH/TO/` with the actual path to your downloaded file. ### Step 3: Restart Claude Desktop After saving the config, restart Claude Desktop completely. ### Step 4: Connect to Your Thingy In Claude Desktop, simply say: ``` "Find and connect to my Nordic Thingy" ``` Claude will: 1. Scan for nearby devices 2. Show you available Thingys 3. Connect to the one you select ## 🎯 Your First Commands ### Control the LED ``` "Turn the Thingy LED red" "Make the LED blue" "Set the LED to purple" "Turn off the LED" ``` ### Play Sounds ``` "Play sound 1 on my Thingy" "Beep twice" "Play a notification sound" ``` ### Read Sensors ``` "What's the temperature?" "Check the air quality" "Show me all sensor readings" ``` ### Create Automation ``` "If temperature goes above 25°C, turn the LED red and beep" "Monitor CO2 levels and alert me if they're too high" ``` ## 📚 Learn More - **[Full Prompt Guide](PROMPT_GUIDE.md)** - 100+ example prompts - **[README](README.md)** - Complete documentation - **[Contributing](CONTRIBUTING.md)** - Help improve this project ## 🆘 Troubleshooting ### Thingy Not Found? - Make sure it's powered on - Check Bluetooth is enabled - Bring it closer to your computer - Try: `"Scan for Thingy devices"` ### Connection Fails? - Restart the Thingy (power off/on) - Restart Claude Desktop - Check console for error messages ### Commands Not Working? - Verify you're connected: `"Is my Thingy connected?"` - Try reconnecting: `"Connect to my Thingy"` - Check the error message for details ## 🎨 Cool Things to Try ### 1. Air Quality Monitor ``` "Monitor CO2 levels every 2 minutes. If above 1000 ppm, set LED to red and alert me" ``` ### 2. Temperature Rainbow ``` "Create a rainbow effect: cycle through red, orange, yellow, green, blue, purple colors" ``` ### 3. Smart Room Health ``` "Check if my room is healthy: - Temperature 20-22°C - Humidity 40-60% - CO2 below 800 ppm Show status with LED color and beep if something is wrong" ``` ### 4. Party Mode ``` "Set up party mode: 1. Alternate between bright colors 2. Play a sound with each color change 3. Do this 10 times" ``` ## 💡 Pro Tips 1. **Be Specific**: The more specific your prompt, the better the result 2. **Chain Commands**: You can combine multiple actions in one prompt 3. **Use Conditions**: "If X then Y" works great for automation 4. **Check Status**: Ask "What's the status?" anytime to see current values ## 🚀 Next Steps 1. Explore the [Full Prompt Guide](PROMPT_GUIDE.md) for advanced examples 2. Try creating your own automation sequences 3. Share your cool prompts with the community 4. Contribute improvements on GitHub ## 📖 Example Session Here's what a typical conversation looks like: **You:** "Find my Thingy and connect" **Claude:** *Scans, finds device, connects* **You:** "What's the temperature?" **Claude:** "The current temperature is 22.3°C" **You:** "If it goes above 25, turn the LED red" **Claude:** *Sets up monitoring* **You:** "Make the LED green for now" **Claude:** *Changes LED to green* **You:** "Check air quality" **Claude:** "CO2: 650 ppm (Good), TVOC: Low, Air quality is excellent!" --- **Ready to start? Just open Claude Desktop and say:** ``` "Connect to my Nordic Thingy and show me what it can do!" ``` 🎉 **Happy Hacking!** --- *Questions? Check the full [README](README.md) or [open an issue](https://github.com/YOUR_USERNAME/nordic-thingy-mcp/issues)*