NocoDB

Servidor MCP de NocoDB

Introducción

El servidor MCP de NocoDB permite una interacción fluida con tu base de datos NocoDB utilizando el Protocolo de Contexto de Modelo (MCP). Este servidor facilita la realización de operaciones CRUD (Crear, Leer, Actualizar, Eliminar) en tablas de NocoDB mediante comandos en lenguaje natural.

Ejemplo de Prompt

[Get Records]
get data from nocodb, table: Shinobi

[Create Record]
add new row, with name: sasuke-2
add other row, with name: naruto-2

[Update Record]
update all rows, remove suffix -

[Delete Record]
delete all rows with name naruto

[Add Column]
add column with name: Age

update all rows, set Age to 18

[Delete Column]
delete column with name: Age

Ejemplo de Prompt - Subir Archivo

[Create table]
from the json files
put on nocodb database
table name is TableShinobi

Archivo de ubicación JSON en: example_upload.json

Ejemplo de Prompt - Crear Registros en Lote y Eliminar Registros en Lote

Acerca de Este Fork

Este repositorio es un fork basado en TypeScript de NocoDB-MCP-Server. Conserva la funcionalidad principal mientras mejora el mantenimiento y la compatibilidad con las prácticas modernas de desarrollo en TypeScript.

Implementación Alojada

Una implementación alojada está disponible en Fronteir AI.

Configuración

Asegúrate de que Node.js y TypeScript estén instalados, luego ejecuta:

npm install
npm run build

Configuración de Variables

Define las variables de entorno requeridas en un archivo .env:

NOCODB_URL=https://your-nocodb-instance.com
NOCODB_API_TOKEN=your_api_token_here
NOCODB_BASE_ID=your_base_id_here

Consejo: Puedes copiar la plantilla desde env.example y completar tus valores.

Cómo Obtener NOCODB_BASE_ID

Para encontrar tu NOCODB_BASE_ID, revisa la URL de tu instancia de Nocodb.
Por ejemplo: https://app.nocodb.com/#/wi6evls6/pqmob3ammcknma5/maty9c5xkmf4012
En este formato de URL:

https://app.nocodb.com/#/{USERNAME}/{NOCODB_BASE_ID}/{TABLE_ID}

Integración con Claude Desktop

Modifica claude_desktop_config.json para incluir:

{
  "mcpServers": {
    "nocodb": {
      "command": "node",
      "args": ["{working_folder}/dist/start.js"],
      "env": {
        "NOCODB_URL": "https://your-nocodb-instance.com",
        "NOCODB_BASE_ID": "your_base_id_here",
        "NOCODB_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Llamada Directa desde CLI

Puedes llamar directamente al servidor MCP desde la línea de comandos:
NOCODB_URL, NOCODB_API_TOKEN y NOCODB_BASE_ID son parámetros requeridos.
NOCODB_URL=https://app.nocodb.com si estás usando NocoDB en la nube.

npx -y nocodb-mcp-server {NOCODB_URL} {NOCODB_BASE_ID} {NOCODB_API_TOKEN} 

Pruebas CLI

Para ejecutar las pruebas, ejecuta:

npx -y @wong2/mcp-cli npx nocodb-mcp-server {NOCODB_URL} {NOCODB_BASE_ID} {NOCODB_API_TOKEN} 

Funciones de la API

Para obtener información detallada sobre las funciones de la API disponibles, consulta API_FUNCTION.md.

Estructura del Proyecto

/project-root
  ├── src/            # TypeScript source files
  ├── dist/           # Compiled JavaScript output
  ├── .env            # Environment variable configurations
  ├── package.json    # Project dependencies and scripts
  ├── tsconfig.json   # TypeScript settings

Guía de Contribuciones

¡Las contribuciones son bienvenidas! No dudes en abrir problemas o enviar solicitudes de extracción.

Licencia

Este proyecto se distribuye bajo MIT.