Servidor MCP de Xano

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de metadatos de Xano. Este servidor proporciona herramientas que pueden usar los asistentes de IA (como Claude) a través de Cursor u otros clientes compatibles con MCP.

Características

• Administrar tablas : cree, enumere y elimine tablas en su base de datos Xano
• Operaciones de esquema : vea y modifique esquemas de tablas con capacidades integrales de edición de esquemas
• Gestión de bases de datos : conjunto completo de herramientas para interactuar con la estructura de su base de datos Xano
• Especificación de Swagger : extraiga los detalles de la API de su grupo de API en formato JSON o Markdown (token reducido)

Tenga en cuenta que esta es una etapa inicial y se agradecen comentarios y solicitudes.

Prerrequisitos

• Node.js (v16 o superior)
• npm u otro administrador de paquetes Node.js
• Una cuenta de Xano con acceso a la API
• Cursor, Claude Desktop, Cline u otro cliente MCP.

Instalación

1. Clonar el repositorio:

2. Instalar dependencias:

3. Configura tus credenciales de Xano:
   • Edite index.ts y configure sus credenciales de Xano:
     • XANO_API_KEY : Su clave API de Xano
     • XANO_WORKSPACE : Su ID de espacio de trabajo de Xano
     • XANO_API_BASE : la URL de la API de su instancia de Xano (por ejemplo, https://your-instance.xano.io/api:meta )
4. Construir el proyecto:

Uso con Claude Desktop

Siga esta guía: https://modelcontextprotocol.io/quickstart/user

Actualice su configuración con:

Reemplace /path/to/xano-mcp con la ruta absoluta al directorio de su proyecto.

Esto no funciona con la aplicación web de Claude, solo a través de la aplicación de escritorio: https://claude.ai/download

Uso con cursor

1. Cursor abierto
2. Haga clic en "Agregar servidor MCP"
3. Configurar el servidor:
   • Nombre: whatever you want to call it
   • Tipo: command
   • Comando: node /path/to/xano-mcp/build/index.js

Reemplace /path/to/xano-mcp con la ruta absoluta al directorio de su proyecto.

Ejemplo de Mac
nodo /Usuarios/su-usuario/Documentos/nombre-de-carpeta/xano-mcp/build/index.js

Si estás dentro de tu directorio, puedes ejecutar el comando 'pwd' en tu terminal para obtener la ruta absoluta.

Descripción general de las herramientas MCP de Xano

Esta integración proporciona un conjunto completo de herramientas para gestionar su espacio de trabajo de Xano mediante el Protocolo de Contexto de Modelo (MCP). Esto es lo que puede hacer:

Gestión de bases de datos

Tablas

• Enumere todas las tablas en su espacio de trabajo
• Ver esquemas de tablas detallados
• Crear nuevas tablas con esquemas personalizados
• Eliminar tablas existentes
• Modificar esquemas de tablas (agregar/eliminar/renombrar columnas)

Operaciones de esquema

• Agregar nuevas columnas con varios tipos de datos
• Eliminar columnas
• Cambiar el nombre de las columnas
• Actualizar esquemas de tablas completos
• Soporte para tipos de datos y relaciones complejos

Gestión de API

Grupos de API

• Crear nuevos grupos de API
• Listar todos los grupos de API
• Explorar API dentro de los grupos
• Habilitar/deshabilitar la documentación de Swagger
• Administrar metadatos del grupo API (etiquetas, ramas, etc.)

API individuales

• Agregar nuevas API a los grupos
• Configurar métodos HTTP (GET, POST, PUT, DELETE, PATCH, HEAD)
• Configurar la documentación de la API
• Agregar metadatos (etiquetas, descripciones)

Documentación

• Generar especificaciones de grupos de API en formatos Markdown (tokens reducidos) y JSO (completo)
• Ver la documentación de Swagger
• Acceda a información detallada del esquema

Este conjunto de herramientas permite la gestión completa de su espacio de trabajo Xano, permitiéndole construir y mantener su infraestructura de backend de forma programada a través de la interfaz MCP.

Cómo volver a habilitar la herramienta Eliminar tabla

Para volver a habilitar la funcionalidad de eliminación de tabla en esta base de código, siga estas instrucciones paso a paso:

1. Abra el archivo src/index.ts en su editor de código
2. Localiza la sección comentada que comienza con:
   // Delete Table Tool /* server.tool(
   y termina con:
   ); */
3. Para descomentar esta sección:
   • Eliminar la apertura /* en la línea después de "Eliminar herramienta de tabla"
   • Eliminar el */ de cierre antes de "Editar esquema de tabla". ¡Listo! La herramienta de eliminación de tablas volverá a estar activa. (Después de ejecutar una nueva compilación).

Ejemplo de cómo debería verse el código después

Verificación

Después de realizar estos cambios:

1. Guardar el archivo
2. Ejecute una nueva compilación `npm run build'
3. Reinicie su cliente MCP (Claude / Cursor)
4. La herramienta de eliminación de tablas ahora debería estar disponible en su conjunto de herramientas

Nota de seguridad

La herramienta de eliminación de tablas elimina permanentemente las tablas de tu espacio de trabajo de Xano. Asegúrate de tener copias de seguridad adecuadas antes de usar esta función.