Arduino MCP Server

Arduino MCP Server: Control Your Arduino with AI!

Welcome to the Arduino MCP Server project! This project lets you control an Arduino board from your computer using a special connection calledMCP (Model Context Protocol). Think of it like giving instructions to your Arduino using a smart AI assistant!

In this project, we're building a "server" that listens for commands from an AI (like Claude Desktop). When the AI tells it to, our Arduino will turn on or off some LEDs. This is a super cool way to see how AI can interact with the real world!

- An Arduino board:Any Arduino board like an Uno or Nano will work.
- Two LEDs:One white and one red.
- Two 1k Resistors:These are important to protect your LEDs.
- Jumper wires:To connect everything.
- USB cable:To connect your Arduino to your computer.
- Claude Desktop:This is the AI assistant we'll be using.
- Python 3.12 or higher:Our code is written in Python.
- uv(Ultrafast Python package installer and resolver):We use this to manage our Python libraries.
- Claude Desktop

- White LED:Connect the longer leg (positive) of the white LED toDigital Pin 12on your Arduino through a 220 Ohm resistor. Connect the shorter leg (negative) to aGND(Ground) pin on your Arduino.
- Red LED:Connect the longer leg (positive) of the red LED toDigital Pin 11on your Arduino through a 220 Ohm resistor. Connect the shorter leg (negative) to aGND(Ground) pin on your Arduino.

(Remember to always use a resistor with LEDs to prevent them from burning out!)

- Open the Arduino IDE (Integrated Development Environment).
- Go to LibraryLibrary Manager> Search and downloadFirmata
- Go toFile>Examples>Firmata>StandardFirmata.
- Select your Arduino board fromTools>Board.
- Select the correct Port fromTools>Port.
- Upload theStandardFirmatasketch to your Arduino board. This program allows Python to control your Arduino.
-

Download the project:If you haven't already, download or clone this project to your computer.

Open your terminal/command prompt:Navigate to the folder where you saved this project.

Install Python dependencies:We'll useuvto install everything our Python code needs.

This command reads thepyproject.tomlfile and installs thefastmcpandpyfirmata2libraries.