Nocodb MCP Server

O que faz o “Nocodb” MCP Server?

O Nocodb MCP Server atua como uma ponte entre assistentes de IA e bancos de dados Nocodb usando o Model Context Protocol (MCP). Este servidor permite que clientes alimentados por IA realizem operações CRUD (Criar, Ler, Atualizar, Excluir) de forma fluida em tabelas Nocodb, facilitando fluxos de trabalho de gerenciamento de dados. Ao expor funcionalidades do banco de dados através da interface MCP, possibilita que LLMs e agentes de IA consultem, criem, atualizem e excluam registros ou colunas, e até mesmo façam upload de arquivos para criar tabelas. Essa integração aumenta a produtividade de desenvolvedores ao automatizar e padronizar interações com o banco de dados, tornando mais fácil construir, testar e implantar aplicações e fluxos de trabalho centrados em banco de dados.

Lista de Prompts

• Get Records: Recupera dados de uma tabela Nocodb especificada.
• Create Record: Adiciona novas linhas com valores especificados em uma tabela.
• Update Record: Atualiza registros existentes, como modificar valores ou remover sufixos.
• Delete Record: Remove registros com base em critérios como nomes correspondentes.
• Add Column: Adiciona novas colunas a uma tabela existente.
• Update Column Values: Define valores de coluna para todas as linhas.
• Delete Column: Remove colunas de uma tabela.
• Create Table from File: Cria uma nova tabela usando dados de um arquivo JSON.
• Bulk Create Records: Adiciona múltiplos novos registros em uma única operação.
• Bulk Delete Records: Remove múltiplos registros de uma vez.

Lista de Recursos

• Tabelas Nocodb: Acesso a todas as tabelas dentro do banco de dados Nocodb conectado, permitindo que os dados sejam lidos e usados como contexto.
• Esquema da Tabela: Metadados sobre a estrutura de cada tabela, como nomes de colunas e tipos de dados.
• Arquivos Enviados: Arquivos JSON (ex: example_upload.json) que podem ser processados para criar ou atualizar tabelas.
• Bulk Sample Data: Exemplos de dados em massa e capturas de tela fornecidos no diretório docs/sample-bulk para demonstração e contexto.

Lista de Ferramentas

• Operações CRUD: Ferramentas para funcionalidades de Criar, Ler, Atualizar e Excluir em tabelas e registros (conforme descrito nos templates de prompt).
• Upload de Arquivo: Ferramenta para processar e enviar arquivos JSON para criar tabelas no Nocodb.
• Operações em Massa: Ferramentas para criação e exclusão em massa de registros em tabelas.

Casos de Uso deste MCP Server

• Gestão de Banco de Dados: Automatize operações CRUD em tabelas Nocodb, otimizando tarefas de entrada, modificação e limpeza de dados para desenvolvedores.
• Migração de Dados: Faça upload e processe arquivos JSON para migrar ou inserir rapidamente dados em bancos Nocodb.
• Evolução de Esquema: Adicione ou remova colunas programaticamente, suportando a evolução de modelos de dados de aplicações.
• Operações de Dados em Massa: Gerencie de forma eficiente a criação ou exclusão de registros em larga escala, útil para processamento em lote ou cenários de testes automatizados.
• Dashboards com IA: Permita que agentes de IA busquem e manipulem dados para relatórios em tempo real, análises ou integrações com dashboards.

Como configurar

Windsurf

1. Certifique-se de que pré-requisitos como Node.js e Nocodb estão instalados.
2. Localize o arquivo de configuração do Windsurf (ex: settings.json).
3. Adicione o Nocodb MCP Server usando o seguinte trecho JSON:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. Salve a configuração e reinicie o Windsurf.
5. Verifique se o servidor está rodando e acessível testando uma operação de banco de dados exemplo.

Claude

1. Instale o Node.js e garanta acesso à instância Nocodb.
2. Edite o arquivo de configuração MCP da plataforma Claude.
3. Adicione o servidor com:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. Reinicie o Claude e verifique a conectividade do servidor.
5. Confirme com um prompt de teste.

Cursor

1. Prepare seu ambiente com Node.js e credenciais do Nocodb.
2. Abra as configurações ou painel de integração MCP do Cursor.
3. Insira a seguinte configuração:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. Salve e reinicie o Cursor.
5. Valide o servidor executando uma operação CRUD.

Cline

1. Configure o Node.js e certifique-se de que o Nocodb está disponível.
2. Edite a configuração do Cline para servidores MCP.
3. Adicione o servidor conforme abaixo:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. Salve as alterações e reinicie o Cline.
5. Teste a configuração conectando-se a uma tabela Nocodb.

Protegendo chaves de API

Armazene as chaves de API usando variáveis de ambiente para segurança. Exemplo:

{
  "env": {
    "NOCODB_API_KEY": "sua-chave-nocodb"
  },
  "inputs": {
    "api_key": "${NOCODB_API_KEY}"
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo de trabalho FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do sistema MCP, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "nocodb-mcp": {
    "transport": "streamable_http",
    "url": "https://seumcpserver.exemplo/caminho/mcp/url"
  }
}

Uma vez configurado, o agente de IA poderá usar este MCP como ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “nocodb-mcp” para o nome real do seu servidor MCP e substituir a URL pela URL do seu próprio servidor MCP.

Visão Geral

Com base na documentação e estrutura disponíveis, o Nocodb MCP Server oferece integração sólida com MCP, um conjunto claro de templates de prompt, recursos e instruções de configuração. No entanto, não há documentação explícita para Roots ou suporte a Amostragem, o que pode limitar sua versatilidade em cenários avançados. No geral, é um servidor MCP prático e bem documentado para fluxos de trabalho de banco de dados.

Pontuação MCP