What is Nocodb Mcp Server

The nocodb_mcp_server is a Model Context Protocol (MCP) server designed for integration with the NocoDB API v2, enabling users to perform various database operations seamlessly.

Use cases

Use cases include managing databases for web applications, automating data entry processes, integrating with other applications via webhooks, and providing a backend for data-driven applications.

How to use

To use nocodb_mcp_server, clone the repository, install the dependencies, configure the environment variables, and run the server using Python.

Key features

Key features include over 40 NocoDB operations such as listing, creating, updating, and deleting databases, tables, and records, as well as batch operations, views, filters, webhooks, and file uploads.

Where to use

Nocodb_mcp_server can be used in various fields that require database management and integration, such as software development, data analysis, and application backend services.

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": "[email protected]"}
)

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 LICENSE para detalhes