MCP Trio

Três servidores MCP poderosos projetados para transformar Agentes de IA em Assistentes Pessoais Executivos.

Este projeto provê três servidores locais integrados sob o Model Context Protocol (MCP), expondo ferramentas e recursos para IA com foco em segurança extrema, contexto pessoal e automação de rotinas financeiras.

🚀 Os Três Servidores

1. 🛡️ mcp-guard: O núcleo de confiança e segurança. Adiciona uma camada de política de risco sobre os agentes, exige aprovação humana para gastos ou writes perigosas, injeta credenciais JIT (Just-In-Time) com tempo de expiração curto e mantém um log imutável de auditoria.
2. 🧠 mcp-life-graph: Um grafo de conhecimento 100% pessoal focado na sua vida. Agrega informações sobre pessoas, cronograma, prazos, gastos e mensagens/e-mails, servindo de cérebro estendido para que a IA não fique pedindo as mesmas informações duas vezes.
3. 📄 mcp-fiscal-br: Fechamento contábil PME/MEI simplificado para o Brasil. Automações de envio PGDAS, importação de NF-e via certificado A1 (protegido pelo Guard), conciliação de notas e adequação aos novos marcos da Reforma Tributária.

💻 Instalação

Você pode utilizar o pacote instalando via pip (nativo em Python), através de contêineres Docker, ou instalando via npm (útil para ecossistema Node/TypeScript).

Via Python (Recomendado)

Requer Python 3.11+.

pip install mcp-trio

Para iniciar o gateway (serviços de rede/SSE para Claude Desktop remoto):

uvicorn mcp_shared.gateway:app --host 0.0.0.0 --port 8000

Via NPM

A distribuição via NPM instala um utilitário CLI (requer que as dependências do Python estejam instaladas no sistema).

npm install -g mcp-trio
mcp-trio

Via Docker

Se preferir o ecossistema isolado:

docker run -p 8000:8000 ghcr.io/mcp-trio/mcp-trio:latest

⚙️ Uso com Claude Desktop / Cursor

Copie o arquivo examples/mcp.json para a pasta de configurações do seu cliente e altere o caminho para a sua instalação (seja chamando o processo Python diretamente via stdio ou conectando ao gateway sse caso rode externamente).

Importante: Os três servidores compartilham o banco de dados e políticas em ~/.mcp-trio/ (ou MCP_TRIO_HOME). Para que a proteção e compartilhamento de contexto funcionem corretamente, mantenha esta estrutura intacta.

🤝 Contribua

O MCP Trio está em fase Beta. Aceitamos PRs, especialmente focados em:

• Melhoria no parsing de arquivos XML da Receita Federal.
• Mais templates de extração para o Life Graph.

Este é um software operacional, não é consultoria jurídica nem o app oficial do Governo ou Receita Federal.