MCP Firebird: encontre e corrija os problemas do seu banco conversando com a sua IA

MCP Firebird é um servidor MCP que permite ao seu assistente de IA diagnosticar de verdade um banco de dados Firebird: planos de execução, conselhos sobre índices, auditoria do esquema, saúde das transações. A versão 0.2.4 está no ar, gratuita para uso interno, testada do Firebird 2.5 ao 5.0.

Uma consulta está lenta. O plano diz CUSTOMERS NATURAL, e na coluna filtrada existe um índice. Percebeu a armadilha?

O índice está INACTIVE. Nesse ponto quase todo conselho, humano ou de IA, manda criar um índice novo. Siga esse conselho e você fica com dois índices sobre a mesma coluna, ambos gravados a cada INSERT, um deles morto. A correção de verdade estava a um ALTER INDEX ... ACTIVE de distância, e ninguém tinha te avisado.

O MCP Firebird te avisa. É um servidor MCP que permite ao seu assistente de IA (Claude, Gemini CLI, Cursor, qualquer coisa que fale MCP) diagnosticar de verdade um banco Firebird: ler o esquema, explicar um plano de execução, propor um índice, recusar-se a propor um que já existe, e medir depois se a meta foi mesmo atingida. Hoje publiquei a versão 0.2.4.

Em resumo

• O que é: um servidor MCP sobre stdio, um único executável Windows escrito em Delphi, que transforma seu assistente de IA em um DBA Firebird operacional.
• Para quem: qualquer um que rode Firebird 2.5, 3.0, 4.0 ou 5.0 e queira respostas sobre planos, índices e saúde do esquema em vez de palpites.
• Funciona com: Claude Desktop, Claude Code, Gemini CLI, OpenCode, Cursor e qualquer cliente MCP.
• Instalação: descompacte, copie .env.example para .env, aponte para o seu banco, registre o exe como servidor stdio.
• Licença: PolyForm Internal Use, gratuita para as operações internas da sua empresa em qualquer escala. Código-fonte no GitHub.

O que ele faz

Nove ferramentas, todas somente leitura: fb_info, fb_list_tables, fb_generate_documentation, fb_analyze_query, fb_suggest_indexes, fb_suggest_index_drops, fb_audit_table, fb_evaluate_goal, fb_monitor_transactions. Cada achado carrega um remédio executável e uma forma de verificar que o remédio realmente ajudou, porque um relatório sobre o qual você não pode agir é só um jeito mais longo de dizer “o banco está lento”.

Duas decisões de design importam mais do que a lista de recursos.

É testado no Firebird 2.5, 3.0, 4.0 e 5.0, não só no mais novo. A suíte completa roda nos quatro motores antes de cada release. As versões se comportam de forma diferente: padrões diferentes, recursos diferentes. Uma ferramenta testada só no 5.0 dá respostas erradas num servidor 2.5, e muitas empresas ainda rodam 2.5 em produção.

Ele não inventa respostas. Se o seu SQL tem um erro, você recebe a mensagem de erro do próprio motor, não um relatório vazio que parece um sinal verde. E quando não pode medir algo, ele avisa: assim você sempre sabe se “nenhum problema encontrado” significa que o banco está bem ou que a ferramenta não conseguiu olhar.

Como é uma sessão de trabalho

Uma sessão real contra o banco de teste da suíte, motor Firebird 5.0.4. É assim que aparece no Claude Desktop:

A captura acima é um único momento dessa sessão. Abaixo percorremos ela inteira, pergunta após pergunta, do primeiro olhar no banco até a correção verificada.

CUSTOMERS
Chave primária: CUSTOMER_ID

| Coluna      | Tipo         | Aceita NULL |
| CUSTOMER_ID | INTEGER      | não         |
| NAME        | VARCHAR(400) | não         |
| CITY        | VARCHAR(240) | sim         |
| STATUS      | CHAR(4)      | sim         |

Índices:
- IDX_CUST_CITY (CITY), INACTIVE
- IDX_CUST_NAME (NAME)
- IDX_CUST_NAME_CITY (NAME, CITY)
- IDX_CUST_STATUS (STATUS)
- RDB$PRIMARY1 (CUSTOMER_ID) [CHAVE PRIMÁRIA]

ALTER INDEX IDX_CUST_CITY ACTIVE;

📝 Essa é a resposta que a maioria dos conselhos erra, humanos ou de IA: teriam mandado você criar um segundo índice.

antes:  meta não atingida  plano: PLAN (CUSTOMERS NATURAL)
depois: meta atingida      plano: PLAN (CUSTOMERS INDEX (IDX_CUST_CITY))

DROP INDEX IDX_ORDERS_CUSTOMER_DUP;
SET STATISTICS INDEX IDX_CUST_NAME;
SET STATISTICS INDEX IDX_CUST_STATUS;

Instalação em dois minutos

Nada roda como serviço e nada escuta em porta alguma: é o seu agente que inicia o executável e fala com ele por stdin/stdout.

1. Descompacte a última versão estável onde quiser.
2. Copie .env.example para .env ao lado do exe e preencha host, banco e credenciais.
3. Aponte firebird.client_lib para a fbclient.dll da sua instalação do Firebird. Nenhuma biblioteca cliente vem no pacote, de propósito: só você sabe com qual servidor está falando.
4. Registre o MCPFirebird.exe no seu agente como servidor MCP stdio. O README tem a receita exata para cada cliente, em inglês, italiano, espanhol e alemão.

A edição Enterprise

A edição gratuita se conecta ao seu banco com uma conexão SQL normal. Ela vê o que o banco sabe sobre si mesmo: esquema, planos de execução, índices, transações. Já é útil, mas fica dentro do banco.

A edição Enterprise é um produto pago: usa-se somente com uma licença, sempre, mesmo na empresa para uso interno. Não existe um nível gratuito da Enterprise. Ela se conecta também ao servidor Firebird como administrador, através do Services Manager. Assim ela vê o que só o servidor conhece: os arquivos de configuração (firebird.conf e databases.conf), o log do servidor (firebird.log), a estrutura física do arquivo, o hardware em que ele roda e a carga de trabalho real. Nada foi tirado da edição gratuita: as ferramentas Enterprise continuam na lista dela, e se o assistente chamar uma, recebe uma mensagem explicando como obtê-la.

Com esse acesso o assistente responde perguntas que antes não podia. O fb_diagnose é o ponto de partida quando algo está errado e você não sabe por onde começar. O fb_analyze_config confere cada parâmetro do firebird.conf contra a sua versão do motor e a sua arquitetura, porque os padrões mudam entre versões. O fb_parse_log lê o firebird.log e encontra corrupção, bugchecks, sweeps que nunca rodaram. O fb_analyze_storage mostra a estrutura física: profundidade dos índices, preenchimento das páginas, cadeias de versões de registro. O fb_analyze_host compara o hardware com a configuração: RAM contra o cache configurado, núcleos contra workers paralelos. O fb_capture_trace grava 60 segundos de carga real e classifica as consultas mais caras; fb_trace_start, fb_trace_status e fb_trace_stop fazem o mesmo por até duas horas, em segundo plano.

Por que vale pagar: a documentação do Firebird não diz qual valor usar para a maioria dos parâmetros, porque o valor certo depende da sua carga de trabalho. A edição Enterprise trabalha medindo. Grava o desempenho sob carga real, você muda um único parâmetro, ela mede de novo e diz se melhorou. Se não melhorou, você volta atrás.

Free vs Enterprise

Licenças Enterprise e suporte: professionals@bittime.it.

Quando você precisa comprar uma licença, e quando não

A edição gratuita sai sob a licença PolyForm Internal Use: código-fonte disponível, gratuita para as operações internas suas e da sua empresa, em qualquer escala, em qualquer setor, consultoria incluída. A regra inteira cabe numa frase: pergunte onde o software vai parar, nunca o que você fez com ele. Enquanto cada cópia ficar nas suas mãos, você não deve nada a ninguém, onde quer que o software rode e qualquer que seja o banco examinado. Você precisa da licença comercial no momento em que uma cópia fica com outra pessoa: você a deixa instalada num cliente ao fim do contrato, a coloca dentro de um produto que vende, ou a oferece como serviço.

Um esclarecimento que merece precisão: a licença comercial de redistribuição e a edição Enterprise são dois produtos diferentes. Uma permite que cópias do MCP Firebird saiam das suas mãos; a outra adiciona as ferramentas de administração do servidor que você leu acima, e é sempre paga, com a sua própria licença, para qualquer um e para qualquer uso. Comprar uma não inclui a outra.

Licenças comerciais: professionals@bittime.it.

Experimente

Baixe a última versão estável, aponte para uma cópia do seu banco e pergunte ao seu assistente por que a sua consulta mais lenta está lenta.

Qual é a primeira pergunta que você faria ao seu banco de dados?