# MCP Trio

[![PyPI version](https://badge.fury.io/py/mcp-trio.svg)](https://badge.fury.io/py/mcp-trio)
[![NPM version](https://badge.fury.io/js/mcp-trio.svg)](https://badge.fury.io/js/mcp-trio)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**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)](https://modelcontextprotocol.io), 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+.

```bash
pip install mcp-trio
```

Para iniciar o gateway (serviços de rede/SSE para Claude Desktop remoto):
```bash
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).
```bash
npm install -g mcp-trio
mcp-trio
```

### Via Docker
Se preferir o ecossistema isolado:
```bash
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**.