Agent Tools

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

# 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.