Developer Tools

MCP Servers

Servidores Model Context Protocol customizados para desenvolvimento com Claude Code. Ferramentas de debugging, validação arquitetural e navegação inteligente de codebase.

💡 O que é MCP?

Model Context Protocol é um padrão da Anthropic que permite estender assistentes de IA (como Claude) com ferramentas customizadas. Em vez do AI "adivinhar" sobre seu codebase, você dá a ele acesso real à sua arquitetura, contratos e convenções.

# Adicionar servidor MCP ao Claude Code
claude mcp add optimus --scope user \
--env PYTHONPATH=/path/to/project \
-- python -m mcp_servers.optimus_project_mcp.stdio_server

🛠️ Servidores Disponíveis

backend_orchestrator_mcp

Ferramentas de debugging para o Backend Orchestrator:

diagnose_gateway_health

Health check completo do gateway

analyze_cache_coherence

Performance do cache PubSub

analyze_rate_limiting

Status de rate limiting por tenant

generate_enterprise_router

Template de router seguindo padrões

optimus_project_mcp

12 ferramentas para navegação inteligente do codebase:

system_overview

Visão geral da arquitetura

service_contract

Contratos de cada microserviço

validate_diff

Validar mudanças contra guardrails

plan_change

Orientações arquiteturais para mudanças

🛡️ Validação Arquitetural

O validate_diff verifica se um diff respeita os guardrails arquiteturais do projeto:

❌ Violação Detectada

ai-engine/src/service.py: Line 42 "import sqlalchemy" ← AI Engine não pode acessar DB diretamente! Guardrail: "All data operations must go through Memory Engine APIs"

✅ Diff Válido

ai-engine/src/service.py: Line 42 "await memory_engine_client.get_data(...)" ✓ Respects Memory Engine API boundary

`🔄 Hot Reload`

Módulos são recarregados sem reiniciar o servidor MCP:

@mcp.tool()
def refresh() -> Dict[str, str]:
"""Reload policy/docs/compose and rebuild validator."""
importlib.reload(validator_module)
indexer.refresh()
return {"status": "refreshed"}

`Stack Técnica`

Python 3.12FastMCPHTTPXRedisYAMLClaude Code

Próximo: Feed-RSS Monitor →