🔧 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ê.

Related MCP server: production-grade-mcp-agentic-system

📦 O que contém

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