# 🔧 MCP Tools + Docker Bridge — Dando Superpoderes ao Seu Agente

## TL;DR

Este repositório contém o código original de produção da **Blu Platform** para o ecossistema MCP (Model Context Protocol). Ele implementa um **Tool Registry** centralizado, isolamento via **Docker Bridge**, validação por **tiers**, **feature flags** por cliente, e um **servidor MCP** baseado em FastMCP.

Se você trabalha com agentes de IA que precisam executar ferramentas de forma segura, escalável e auditável, este código é pra você.

---

## 📦 O que contém

| Módulo | Descrição |
|---|---|
| **🔬 Registry** | Registro central de ferramentas MCP |
| **🐳 Docker Bridge** | Isolamento de execução de tools via Docker |
| **📊 Tier Validator** | Validação de tiers (permissões) por ferramenta |
| **📋 Tool Metadata** | Metadados e descrição estruturada de tools |
| **🔌 Features** | Feature flags por cliente |
| **🔗 Resource Resolver** | Resolução dinâmica de recursos MCP |
| **⚡ MCP Server** | Servidor MCP principal (FastMCP) |
| **🛠️ Tools** | Registro e handlers de ferramentas |
| **🧩 Helpers** | Utilitários compartilhados entre tools |
| **🐳 Docker Adapter** | Adaptador Docker para o MCP |
| **🧠 RAG Module** | Busca RAG (Retrieval-Augmented Generation) |
| **🗄️ SQL Module** | Execução segura de SQL |
| **🌐 Web Crawl** | Crawling e scraping de páginas web |
| **💾 Memory Module** | Memória compartilhada entre tools |

---

## 📁 Estrutura

```
mcp-agent-tools/
├── libs/
│   └── blu_tool_registry/       # Núcleo: registry, docker bridge, tiers, features, metadata
├── services/
│   └── tool_pool_api/server/    # Servidor MCP, tools, helpers, adapters
│       └── tool_modules/        # Módulos funcionais (RAG, SQL, Web Crawl, Memory)
├── adapters/                    # Adaptadores diversos
├── examples/                    # Exemplos de uso
├── run.py                       # Entrypoint principal
├── pyproject.toml
└── README.md
```

---

## ⚡ Quick Start

```bash
# Clone o repositório
git clone <url>
cd mcp-agent-tools

# Instale as dependências
pip install .

# Inicie o servidor MCP
python run.py

# Ou apenas veja as ferramentas disponíveis
python run.py --info
```

Dependências mínimas: `fastmcp`, `mcp`, `httpx`. Para o Docker Bridge: `pip install docker`.

---

## 💡 Inspiração

Este código foi originalmente desenvolvido como parte da **Blu Platform**, uma plataforma de automação inteligente que utiliza agentes de IA para executar tarefas complexas de forma segura e escalável.

Princípios que guiaram o design:

- **Segurança primeiro**: Isolamento Docker para ferramentas não-confiáveis
- **Flexibilidade**: Feature flags por cliente permitem ativar/desativar tools dinamicamente
- **Auditabilidade**: Todo registro de ferramenta inclui metadados completos
- **Simplicidade**: FastMCP como base mantém o código leve e testável
- **Extensibilidade**: Novos tool modules são adicionados sem modificar o core

---

## 📄 Licença

MIT — Use, modifique, compartilhe. Créditos são bem-vindos, mas não obrigatórios.

---

> Feito com 🔧 para a comunidade de agentes de IA.