betofilippi/nocodb_mcp_server

NocoDB MCP Server

Servidor MCP (Model Context Protocol) para integração com NocoDB API v2.

🚀 Instalação

1. Clone o repositório

git clone https://github.com/betofilippi/nocodb_mcp_server.git
cd nocodb_mcp_server

2. Instale as dependências

pip install -r requirements.txt

3. Configure as variáveis de ambiente

cp .env.example .env

Edite o arquivo .env:

NOCODB_BASE_URL=https://nocodb.plataforma.app/api/v2
NOCODB_API_KEY=seu_token_api_aqui

4. Execute o servidor

python mcp_nocodb_server_full.py

🛠️ Funcionalidades

O servidor oferece mais de 40 operações NocoDB:

Bases de Dados

• list_bases - Lista todas as bases
• get_base - Obtém detalhes de uma base
• create_base - Cria nova base
• update_base - Atualiza base
• delete_base - Remove base

Tabelas

• list_tables - Lista tabelas
• get_table - Obtém detalhes da tabela
• create_table - Cria nova tabela
• update_table - Atualiza tabela
• delete_table - Remove tabela

Registros

• list_records - Lista registros com filtros
• get_record - Obtém registro específico
• create_record - Cria novo registro
• update_record - Atualiza registro
• delete_record - Remove registro

Operações em Lote

• bulk_create_records - Cria múltiplos registros
• bulk_update_records - Atualiza múltiplos registros
• bulk_delete_records - Remove múltiplos registros

Outras Funcionalidades

• Views e filtros
• Ordenação
• Webhooks
• Compartilhamento
• Busca global
• Comentários
• Upload de arquivos

💡 Uso com Claude

Este servidor é compatível com o Claude Desktop App. Para adicionar:

# macOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Adicione:

{
  "mcpServers": {
    "nocodb": {
      "command": "python",
      "args": ["/caminho/para/mcp_nocodb_server_full.py"],
      "env": {
        "NOCODB_BASE_URL": "https://nocodb.plataforma.app/api/v2",
        "NOCODB_API_KEY": "seu_token"
      }
    }
  }
}

📝 Exemplos de Uso

Listar Bases

result = server.list_bases()

Criar Registro

result = server.create_record(
    table_id="tbl_123",
    record_data={"nome": "João", "email": "joao@email.com"}
)

Buscar Registros com Filtro

result = server.list_records(
    table_id="tbl_123",
    where="(Status,eq,Ativo)",
    limit=10
)

🔒 Segurança

• Nunca commite seu token de API
• Use variáveis de ambiente
• Gere tokens específicos com permissões limitadas

📄 Licença

MIT - veja para detalhes