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

Intents Supported

Intent	Description	Parameters
TurnOnLed	Turns on a specific LED	`{ "color": "red" }`
TurnOffLed	Turns off all LEDs	`none`
SetPattern	Sets specific LED pattern	`{ "pattern": "1100" }`
SetMood	Uses predefined mood pattern	`{ "mood": "calm" }`
PowerDown	Alias for turning everything off	`none`
GetStatus	Queries the current LED state	`none`

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 requests

Running the Server

uvicorn mcp_server:app --reload

Then 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

mcp_server.py: Main FastAPI server with intent handling logic
requirements.txt: Python dependencies
README.md: Project overview and usage

License

MIT License

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

A Model Context Protocol server that translates high-level intents into commands for controlling an Arduino-based LED system via a RESTful interface.

Related MCP Servers

Home Assistant MCP Server
miguelg719
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Home Assistant to provide smart home control capabilities through natural language, supporting devices like lights, climate systems, locks, alarms, and humidifiers.
Last updated -
2
Python
MIT License
OpenAPI MCP Server
rahgadda
-
security
A
license
-
quality
A Model Context Protocol Server that enables LLMs to interact with and execute REST API calls through natural language prompts, supporting GET/PUT/POST/PATCH operations on configured APIs.
Last updated -
6
Python
Apache 2.0
MCP Android Agent
nim444
-
security
A
license
-
quality
A Model Context Protocol server that enables AI agents to control and automate Android devices through natural language, supporting actions like app management, UI interactions, and device monitoring.
Last updated -
14
Python
MIT License
Hue MCP Server
rmrfslashbin
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants to control Philips Hue smart lighting systems through natural language commands.
Last updated -
1
TypeScript
MIT License

View all related MCP servers

MCP LEDAPI Intent Controller