Controls an Arduino-based LED system through a RESTful interface, allowing for high-level commands like turning LEDs on/off, setting patterns, and controlling LED moods through an Arduino Nano connected via USB.
Implements the Model Context Protocol server using FastAPI framework, providing a RESTful interface for interpreting high-level intents and exposing a Swagger UI for testing.
Communicates with an Arduino LED API built with Flask that serves as the intermediary between the MCP intent server and the physical Arduino hardware.
Automatically exposes a Swagger UI interface for testing the API endpoints and intents, accessible through the browser at localhost:8000/docs.
MCP LEDAPI Intent Controller
This project implements a Model Context Protocol (MCP)-style server using FastAPI to control an Arduino-based LED system via a RESTful interface.
For best results, use this together with the MCPForLedAPI project.
It interprets high-level intents like TurnOnLed, SetMood, or GetStatus, and translates them into commands for the Arduino LED API.
Features
Supports contextual LED control via structured intents
Communicates with an Arduino LED controller API (
/setLedStatus,/status)Automatically exposes Swagger UI for testing
Extensible architecture for adding new devices or control logic
Related MCP server: OpenAPI MCP Server
Intents Supported
Intent | Description | Parameters |
TurnOnLed | Turns on a specific LED |
|
TurnOffLed | Turns off all LEDs |
|
SetPattern | Sets specific LED pattern |
|
SetMood | Uses predefined mood pattern |
|
PowerDown | Alias for turning everything off |
|
GetStatus | Queries the current LED state |
|
Example Requests
Requirements
Python 3.8+
FastAPI
Uvicorn
Requests
Install via:
Running the Server
Then open your browser at:
Swagger UI: http://localhost:8000/docs
ReDoc UI: http://localhost:8000/redoc
Architecture Overview
File Overview
mcp_server.py: Main FastAPI server with intent handling logicrequirements.txt: Python dependenciesREADME.md: Project overview and usage
License
MIT License