mcp -firebird

Este MCP servidor Firebird conecta assistentes de IA a bancos Firebird reais, permitindo executar queries SQL, listar tabelas e verificar o status do servidor de forma segura. As ferramentas MCP disponíveis incluem test_connection para diagnosticar a conectividade, execute_query para rodar comandos SQL com suporte a parâmetros e transações, list_tables para enumerar as tabelas do banco, e server_status para ver o estado atual das bibliotecas e da configuração. Para começar, configure as variáveis de ambiente com os detalhes do seu servidor Firebird e inicie o contêiner Docker. Em seguida, utilize as funções através da camada MCP para interagir com o banco sem precisar expor credenciais ou estabelecer conexões manualmente.

Pré-requisitos:

• Docker instalado na máquina onde o MCP será executado
• Acesso a um servidor Firebird externo
• Informações de conexão (host, porta, banco, usuário, senha)

Passos:

1. Obtenha a imagem Docker do MCP Firebird (ou use o comando abaixo como base): ghcr.io/marcelofmatos/mcp-server-firebird:latest

2. Inicie o container com as variáveis de ambiente apropriadas (exemplo): docker run -d
   --name mcp-firebird
   -e FIREBIRD_HOST=192.168.1.50
   -e FIREBIRD_PORT=3050
   -e FIREBIRD_DATABASE=/dados/sistema.fdb
   -e FIREBIRD_USER=SYSDBA
   -e FIREBIRD_PASSWORD=masterkey
   ghcr.io/marcelofmatos/mcp-server-firebird:latest

3. Verifique se o container está rodando: docker ps | grep mcp-firebird docker logs mcp-firebird

4. Integre com seu cliente MCP/ia para enviar comandos às ferramentas disponíveis (test_connection, execute_query, list_tables, server_status).

Dicas:

• Use as variáveis Firebird_language e LANG para internacionalização (pt_BR ou en_US); a configuração pode ser feita via FIREBIRD_LANGUAGE ou LANG do host.
• Não exponha credenciais no código; utilize variáveis de ambiente ou mecanismos seguros de secret management.
• A imagem já inclui o Firebird Client dentro do contêiner para facilitar conectividade externa.
• Verifique logs de diagnóstico se enfrentar falhas de conexão; use server_status para confirmar versões de bibliotecas e status do MCP.
• Você pode definir MCP_SERVER_NAME e MCP_SERVER_VERSION para melhor rastreabilidade em logs e métricas.