Happy slice of mcp pizzaMCP.pizza
Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

kotlin-mcp-hue-light-sample

MCP.Pizza Chef: SebastianAigner

kotlin-mcp-hue-light-sample is an MCP server built with Kotlin that enables integration between Claude Desktop LLM client and Philips Hue smart lights. It demonstrates how to use the official Kotlin SDK to create a self-sufficient MCP server that controls smart home lighting through natural language commands. The project includes interface definitions, Ktor-based networking, and debugging with the MCP inspector, showcasing practical hardware control via LLMs.

Use This MCP server To

Control Philips Hue smart lights using natural language commands Integrate Claude Desktop LLM client with smart home devices Develop Kotlin-based MCP servers for IoT device management Debug MCP server interactions using MCP inspector Build custom smart home automation workflows with LLMs

README

🎥 Building MCP with Kotlin: Claude Desktop Controls my Smart Home Lights!

This repo contains supplemental code for this YouTube video.

The Model Context Protocol Kotlin SDK (https://github.com/modelcontextprotocol/kotlin-sdk) makes it easy for you to build integrations between LLM clients like Claude Desktop and your own applications, whether that's software or hardware! Let's see it in practice: Join Sebastian Aigner building an integration between Hue Smart Lights and Claude Desktop, powered entirely by Kotlin. We walk through defining our interfaces, delegating some of the more mechanical tasks when working with Ktor to Junie, and then implement a basic version of an MCP using the official SDK for Kotlin. We use the MCP inspector to explore and debug our application, and finally integrate the Kotlin Gradle application with Claude Desktop by setting up the final configuration. In the end, we have a self-sufficient MCP server that can control smart lights with natural language!

Junie, the coding agent by JetBrains: https://www.jetbrains.com/junie/

MCP Server Plugin for JetBrains IDEs: https://plugins.jetbrains.com/plugin/26071-mcp-server

MCP inspector: https://github.com/modelcontextprotocol/inspector

How to run

Run the installDist Gradle task, and point your MCP client to the generated startup script in build/install/huelight-mcp/bin.

kotlin-mcp-hue-light-sample FAQ

How do I set up the kotlin-mcp-hue-light-sample server?
Clone the repository, install Kotlin SDK dependencies, configure your Philips Hue credentials, and run the server with Gradle.
Can this MCP server control other smart home devices?
This sample is designed for Philips Hue lights but can be extended to other devices by modifying the interfaces and implementation.
What LLM clients are compatible with this MCP server?
It is demonstrated with Claude Desktop but can work with any MCP-compatible LLM client like OpenAI GPT-4 or Gemini.
How does the MCP inspector help during development?
The MCP inspector allows you to explore, debug, and monitor the server’s context and interactions in real time.
Is prior Kotlin experience required to use this MCP server?
Basic Kotlin knowledge helps but the sample includes detailed steps and code to guide developers through setup and customization.
How does this server handle network communication?
It uses Ktor, a Kotlin networking framework, to manage HTTP requests and responses for MCP protocol interactions.