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.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP LEDAPI Intent Controllerset mood to calm"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
POST /intent
{
"intent": "TurnOnLed",
"parameters": {
"color": "green"
}
}POST /intent
{
"intent": "SetMood",
"parameters": {
"mood": "calm"
}
}Requirements
Python 3.8+
FastAPI
Uvicorn
Requests
Install via:
pip install fastapi uvicorn requestsRunning the Server
uvicorn mcp_server:app --reloadThen open your browser at:
Swagger UI: http://localhost:8000/docs
ReDoc UI: http://localhost:8000/redoc
Architecture Overview
[ User or System ]
↓
MCP Intent Server (FastAPI)
↓
Arduino LED API (Flask)
↓
Arduino Nano (via USB)File Overview
MCPForLedAPI.py: Main FastAPI server with intent handling logicrequirements.txt: Python dependenciesREADME.md: Project overview and usage
License
MIT License
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.