IPEDTools MCP: Modelos de Linguagem Consultando Índices do IPED por Model Context Protocol
IPEDTools MCP: Modelos de Linguagem Consultando Índices do IPED por Model Context Protocol
O IPEDTools MCP conecta clientes de modelos de linguagem aos índices de casos do IPED por meio de um servidor do Model Context Protocol. A ligação permite perguntar, em linguagem natural, sobre a prova digital já processada e desloca o debate sobre automação, viés e rastreabilidade para dentro da perícia.
O Que é?
O IPED [Indexador e Processador de Evidências Digitais] é uma ferramenta de código aberto em Java, desenvolvida por peritos da Polícia Federal desde 2012, com código publicado em 2019 no repositório sepinf-inc/IPED. O IPED indexa o conteúdo de mídias e dispositivos em índices Lucene, guarda metadados em SQLite e registra marcações no arquivo. bookmarks.iped.
O IPEDTools é um complemento gráfico do IPED. O IPEDTools MCP é um servidor MCP sobre transporte STDIO que expõe o índice de um caso a clientes compatíveis. A perícia permanece com o perito, e o servidor oferece ao modelo uma porta de consulta ao índice.
Para Que Serve?
O servidor permite que um modelo de linguagem consulte o índice de um caso e retorne itens, comunicações e linhas do tempo. A página do projeto lista as ferramentas expostas ao modelo: search_documents [busca de documentos], get_property_dictionary [dicionário de propriedades], get_communications_graph [grafo de comunicações], get_timeline [linha do tempo], set_item_checked e marcação em bookmark [marcação de itens] e query_ai_detections [consulta às detecções por IA]. O comando /start_case inicia a análise de um caso.
Os clientes suportados incluem modelos locais [LM Studio, Ollama, LocalAI, Jan.ai] e modelos em nuvem [Claude Desktop, Cursor, Gemini, OpenAI]. A demonstração da página usa um caso com 340.871 itens distribuídos em 11 categorias.
Como Funciona?
O Model Context Protocol define clientes e servidores que trocam mensagens JSON-RPC. No transporte STDIO, previsto na especificação de 18 de junho de 2025, o cliente inicia o servidor como um subprocesso local e se comunica por meio de entrada e saída padrão, com mensagens delimitadas por quebra de linha e registros de log em stderr.
O IPEDTools MCP segue o modelo. Um configurador gráfico gera o JSON de configuração, que o usuário copia para o cliente. O pacote embute Java 21 [JRE Liberica, empacotado com jpackage] e sai em duas formas: instalador MSI e ZIP portátil. O download exige cadastro com perfil completo. Os resultados das ferramentas são retornados ao cliente, que os entrega ao modelo em uso.
Como Aplicar na Prática do Direito Penal e Processo Penal
Acesso ao Índice
A página do fornecedor descreve o acesso ao caso como somente leitura. A mesma página lista ferramentas de marcação de itens e de bookmark, funções que são gravadas no índice do caso. A descrição de leitura é uma afirmação do fornecedor, e o alcance da gravação requer teste em cenário fictício antes de qualquer uso em cenário real. A página orienta o usuário a configurar o modelo para que ele acesse os arquivos e para que o MCP permaneça no índice.
Destino do Dado
Com modelo local, a consulta permanece na máquina do perito. Com modelo em nuvem, o cliente envia ao provedor os resultados das ferramentas, que contêm nomes, mensagens e trechos de arquivos. A Lei 13.709/2018, art. 4º, III e § 1º, exclui do âmbito da LGPD o tratamento realizado para fins exclusivos de investigação e repressão de infrações penais e remete a matéria à legislação específica.
Cadeia de Custódia
Os arts. 158-A a 158-F do Código de Processo Penal [Decreto-Lei 3.689/1941, com redação da Lei 13.964/2019] disciplinam a cadeia de custódia do vestígio. A resposta de um modelo de linguagem é uma saída de software, e o item original do IPED, identificado por hash, é o vestígio.
O método proposto separa as funções. O modelo localiza, o perito confere o item original na ferramenta pericial, e o laudo cita o item por identificador e hash. O registro das consultas e das marcações acompanha o laudo para fins de contraditório. O viés de automação [tendência a aceitar a saída do sistema sem conferência] justifica a etapa de conferência.
Em Linguagem Simples
O IPED funciona como o catálogo de uma biblioteca: o perito registrou o conteúdo do celular ficha por ficha. O MCP abre um guichê em que um assistente pergunta ao catálogo e recebe de volta as fichas pedidas. O assistente pode errar ao resumir; a ficha original é a prova.
Representação Visual
Cinco etapas em sequência: índice do caso IPED, servidor IPEDTools MCP, cliente MCP, modelo local ou na nuvem e conferência no item original. Dois pontos de risco: gravação de bookmarks no servidor e vazamento de dados para o modelo em nuvem. Índice do caso: IPED Servidor, IPEDTools, MCP Cliente, MCP do usuário. Modelo local ou na nuvem. Conferência no item original. Ferramentas de marcação gravam bookmarks. Na nuvem, os resultados das consultas seguem o provedor Hash e os identificadores entram no laudo.
POP: Procedimento Operacional Padrão
Nível 1: Operação Básica
Cadastrar-se em ipedtools.com.br e completar o perfil.
Baixar o instalador MSI ou o ZIP portátil.
Instalar ou extrair o pacote, que traz Java 21 embutido.
Abrir o configurador gráfico e indicar o índice do caso IPED.
Copiar o JSON gerado para a configuração do cliente escolhido.
Iniciar a análise com
/start_case.
Nível 2: Uso no Processo Penal
Trabalhar com a cópia do índice e registrar no laudo o hash do original.
Preferir o modelo local e documentar o modelo, a versão e a configuração.
Testar, em um caso fictício, se o servidor grava no índice.
Registrar cada consulta e cada resposta.
Conferir cada item citado no item original do IPED, pelo identificador e pelo hash.
Reservar a marcação de itens e de bookmark a perito responsável, com registro.
Juntar ao laudo os registros para o contraditório.
Perguntas Frequentes
O que o download exige?
Cadastro com perfil completo no site do projeto.
Quais clientes funcionam com o servidor?
A página cita LM Studio, Ollama, LocalAI e Jan.ai como modelos locais, e Claude Desktop, Cursor, Gemini e OpenAI como opções em nuvem.
Os dados saem da máquina?
Com um modelo local, a consulta fica na máquina. Com modelo em nuvem, os resultados das ferramentas ficam com o provedor.
A resposta do modelo vale como prova?
O item original do IPED, preservado sob cadeia de custódia, é o vestígio. A resposta do modelo auxilia a localização e passa por conferência.
A ferramenta altera o caso?
A página descreve o acesso de leitura e lista as ferramentas de marcação que gravam bookmarks. O teste em caso fictício esclarece o alcance da gravação.
Qual o requisito técnico?
Instalador MSI ou ZIP portátil, com Java 21 embutido no pacote.
Glossário
Bookmark
Marcação do item em caso de IPED, gravada no arquivo bookmarks.iped.
Cadeia de Custódia
Conjunto de procedimentos documentais aplicados ao vestígio, disciplinado nos arts. 158-A a 158-F do Código de Processo Penal.
Hash
Sequência de caracteres calculada por uma função matemática a partir do conteúdo de um arquivo.
IPED
Ferramenta de código aberto em Java para indexação e processamento de evidências digitais, desenvolvida por peritos da Polícia Federal.
JSON-RPC
Protocolo de chamada remota de procedimentos com mensagens em formato JSON.
Lucene
Biblioteca Java para indexação e busca de texto.
MCP [Model Context Protocol]
Protocolo de troca de mensagens JSON-RPC entre clientes de modelos de linguagem e servidores de ferramentas e de dados.
STDIO
Transporte do MCP em que o cliente inicia o servidor como um subprocesso local e troca mensagens por meio de entrada e saída padrão.
Viés de Automação
Tendência a aceitar a saída do sistema automatizado sem conferência.
Fontes:
https://www.ipedtools.com.br/mcp [site oficial do IPEDTools MCP]
https://github.com/sepinf-inc/IPED [repositório do IPED]
https://modelcontextprotocol.io/specification/2025-06-18/basic/transports [especificação MCP, transportes]