iot-mcp-bridge

francenylson1/iot-mcp-bridge

3.1

If you are the rightful owner of iot-mcp-bridge and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The IoT MCP Bridge is a modern IoT system that enables control of ESP8266 and Raspberry Pi devices using natural language through Claude Desktop, ideal for educational purposes, demonstrations, and maker projects.

Tools
1
Resources
0
Prompts
0

🍃 IoT MCP Bridge - Controle IoT via Linguagem Natural

🚀 Visão Geral

Sistema IoT moderno que permite controlar dispositivos ESP8266 e Raspberry Pi usando linguagem natural através do Claude Desktop. Ideal para educação, demonstrações e projetos maker.

✨ Características

  • 🤖 Controle via Linguagem Natural - "Acenda o LED verde"
  • 🍃 Suporte ESP8266/NodeMCU - LEDs e sensores físicos
  • 🍓 Suporte Raspberry Pi - Simulação completa
  • 🎯 Interface Claude Desktop - Integração nativa
  • 📱 Múltiplos Dispositivos - Rede local
  • 🎓 Educacional - Perfeito para aulas de IoT

🛠️ Tecnologias

  • Python 3.8+
  • FastMCP 2.0 - Protocolo MCP
  • aiohttp - Comunicação assíncrona
  • ESP8266/NodeMCU - Hardware IoT
  • Claude Desktop - Interface de usuário

📦 Instalação

1. Clonar o Repositório

git clone https://github.com/seu-usuario/iot-mcp-bridge.git
cd iot-mcp-bridge

2. Criar Ambiente Virtual

python -m venv iot-mcp-env
source iot-mcp-env/bin/activate  # Linux/Mac
# ou
iot-mcp-env\Scripts\activate     # Windows

3. Instalar Dependências

pip install -r requirements.txt

4. Configurar ESP8266

  1. Carregar examples/esp8266_firmware.ino no ESP8266
  2. Configurar WiFi no firmware
  3. Anotar o IP do ESP8266
  4. Atualizar IP em src/esp8266_controller.py

⚙️ Configuração Claude Desktop

1. Copiar Configuração

Copie o conteúdo de claude_desktop_config.json para as configurações do Claude Desktop.

2. Localizar Arquivo de Configuração

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

3. Adicionar Configuração

{
  "mcpServers": {
    "iot-mcp-bridge": {
      "command": "python",
      "args": ["mcp_fastmcp2_correct.py"],
      "env": {
        "PYTHONPATH": "."
      }
    }
  }
}

🎯 Como Usar

1. Iniciar Claude Desktop

Abra o Claude Desktop e verifique se o MCP Bridge está conectado.

2. Comandos de Exemplo

"Qual o status do ESP8266?"
"Acenda o LED verde do ESP8266"
"Desligue o LED azul do ESP8266"
"Leia o sensor de luz do ESP8266"
"Faça o LED vermelho piscar por 5 segundos"
"Mostre o status de todos os dispositivos"

3. Comandos Disponíveis

ESP8266
  • esp8266_get_status - Status completo
  • esp8266_control_led - Controlar LEDs
  • esp8266_read_sensor - Ler sensores
  • esp8266_blink_led - Piscar LEDs
Raspberry Pi (Simulação)
  • raspberry_control_led - Controlar LEDs
  • raspberry_read_sensor - Ler sensores
  • raspberry_read_button - Ler botão
Sistema
  • get_system_status - Status geral
  • list_devices - Listar dispositivos
  • emergency_stop - Parada de emergência

🔧 Hardware

ESP8266/NodeMCU

LED Vermelho → GPIO 12 (D6)
LED Verde   → GPIO 4  (D2)
LED Azul    → GPIO 5  (D1)
Sensor LDR  → A0 (pino analógico)

Conexões

  • Conectar LEDs com resistores (220Ω)
  • Conectar sensor LDR com resistor (10kΩ)
  • Alimentar com 3.3V

📁 Estrutura do Projeto

iot-mcp-bridge/
├── mcp_fastmcp2_correct.py          # 🚀 MCP Bridge principal
├── claude_desktop_config.json       # ⚙️ Configuração Claude Desktop
├── src/
│   ├── esp8266_controller.py        # 🍃 Controlador ESP8266
│   └── raspberry_controller.py      # 🍓 Controlador Raspberry Pi
├── examples/
│   └── esp8266_firmware.ino        # 🍃 Firmware ESP8266
├── config/
│   └── settings.py                 # ⚙️ Configurações
├── requirements.txt                # 📦 Dependências
└── README.md                      # 📖 Este arquivo

🎓 Aplicações Educacionais

Para Professores

  • Demonstrações IoT - Controle via linguagem natural
  • Aulas de Programação - Conceitos de IoT
  • Projetos Maker - Integração hardware/software

Para Alunos

  • Primeiros Passos IoT - Interface intuitiva
  • Experimentos Práticos - LEDs e sensores
  • Aprendizado de IA - Linguagem natural

🚨 Solução de Problemas

ESP8266 Não Responde

  1. Verificar se o firmware foi carregado
  2. Verificar conexão WiFi
  3. Verificar IP no código
  4. Testar com ping [IP_ESP8266]

Claude Desktop Não Conecta

  1. Verificar configuração MCP
  2. Verificar se o arquivo existe
  3. Verificar dependências instaladas
  4. Reiniciar Claude Desktop

LEDs Não Acendem

  1. Verificar conexões físicas
  2. Verificar GPIOs no firmware
  3. Verificar alimentação
  4. Testar com Serial Monitor

🤝 Contribuição

  1. Fork o projeto
  2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
  3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
  4. Push para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

👨‍🏫 Autor

Fran - Aluno Maker Digital

  • Projeto educacional para ensino de IoT
  • Integração com Claude Desktop
  • Foco em linguagem natural e IA

🙏 Agradecimentos

  • Anthropic - Claude Desktop e MCP
  • FastMCP - Framework MCP
  • ESP8266 Community - Hardware e firmware
  • Comunidade Maker - Inspiração e suporte

⭐ Se este projeto te ajudou, considere dar uma estrela no GitHub!