Servidor Verodat MCP

Descripción general

Una implementación de servidor de Protocolo de contexto de modelo (MCP) para Verodat , que permite una integración perfecta de las capacidades de gestión de datos de Verodat con sistemas de IA como Claude Desktop.

Servidor Verodat MCP

Este repositorio contiene una implementación de servidor de Protocolo de contexto de modelo (MCP) para Verodat, que permite que los modelos de IA interactúen con las capacidades de gestión de datos de Verodat a través de herramientas bien definidas.

Descripción general

El servidor MCP de Verodat proporciona una forma estandarizada para que los modelos de IA accedan y manipulen datos en Verodat. Implementa la especificación del Protocolo de Contexto de Modelo (MPP), proporcionando herramientas para el consumo, el diseño y la gestión de datos.

Categorías de herramientas

El servidor está organizado en tres categorías principales de herramientas, cada una de las cuales ofrece un conjunto progresivo de capacidades:

1. Consumir (8 herramientas)

La categoría base se centró en operaciones de recuperación de datos:

get-accounts : Recuperar cuentas disponibles
get-workspaces : enumera los espacios de trabajo dentro de una cuenta
get-datasets : enumera conjuntos de datos en un espacio de trabajo
get-dataset-output : recupera datos reales de un conjunto de datos
get-dataset-targetfields : recupera definiciones de campos para un conjunto de datos
get-queries : recupera consultas de IA existentes
get-ai-context : Obtener el contexto del espacio de trabajo y la estructura de datos
execute-ai-query : Ejecuta consultas impulsadas por IA en conjuntos de datos

2. Diseño (9 herramientas)

Incluye todas las herramientas de Consume, más:

create-dataset : Crea un nuevo conjunto de datos con un esquema definido

3. Administrar (10 herramientas)

Incluye todas las herramientas de Diseño, más:

upload-dataset-rows : Cargar filas de datos a conjuntos de datos existentes

Prerrequisitos

Node.js (v18 o superior)
Git
Claude Desktop (para la integración de Claude)
Cuenta de Verodat y clave API de IA

Instalación

Inicio rápido

Instalación mediante herrería

Para instalar Verodat MCP Server para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @Verodat/verodat-mcp-server --client claude

Instalación manual

Clonar el repositorio:

git clone https://github.com/Verodat/verodat-mcp-server.git
cd verodat-mcp-server

Instalar dependencias y compilar:

npm install
npm run build

Configurar Claude Desktop: Cree o modifique el archivo de configuración:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json Agregue la configuración que se menciona a continuación en configuración:

Introducción a Verodat

Regístrese para obtener una cuenta Verodat en verodat.com
Genere una clave API de IA desde su panel de Verodat
Agregue la clave API a su configuración de Claude Desktop

Configuración

El servidor requiere configuración para la autenticación y los puntos finales de la API. Cree un archivo de configuración para su modelo de IA:

{
  "mcpServers": {
    "verodat-consume": {
      "command": "node",
      "args": [
        "path/to/verodat-mcp-server/build/src/consume.js"
      ],
      "env": {
        "VERODAT_AI_API_KEY": "your-api-key",
        "VERODAT_API_BASE_URL": "https://verodat.io/api/v3"
      }
    }
  }
}

Opciones de configuración

Puede configurar cualquiera de las tres categorías de herramientas especificando el archivo JS apropiado uno a la vez en claude:

Solo consumir : utilice consume.js (8 herramientas para la recuperación de datos)
Capacidades de diseño : Utilice design.js (9 herramientas, incluye creación de conjuntos de datos)
Gestión completa : utilice manage.js (10 herramientas, incluye carga de datos)

Ejemplo para configurar las tres categorías simultáneamente:

{
  "mcpServers": {
    "verodat-consume": {
      "command": "node",
      "args": [
        "path/to/verodat-mcp-server/build/src/consume.js"
      ],
      "env": {
        "VERODAT_AI_API_KEY": "your-api-key",
        "VERODAT_API_BASE_URL": "https://verodat.io/api/v3"
      }
    },
    "verodat-design": {
      "command": "node",
      "args": [
        "path/to/verodat-mcp-server/build/src/design.js"
      ],
      "env": {
        "VERODAT_AI_API_KEY": "your-api-key",
        "VERODAT_API_BASE_URL": "https://verodat.io/api/v3"
      }
    },
    "verodat-manage": {
      "command": "node",
      "args": [
        "path/to/verodat-mcp-server/build/src/manage.js"
      ],
      "env": {
        "VERODAT_AI_API_KEY": "your-api-key",
        "VERODAT_API_BASE_URL": "https://verodat.io/api/v3"
      }
    }
  }
}

Variables de entorno

VERODAT_AI_API_KEY : Su clave API de Verodat para autenticación
VERODAT_API_BASE_URL : La URL base para la API de Verodat (el valor predeterminado es " https://verodat.io/api/v3 " si no se especifica)

Guía de uso de herramientas

Comandos disponibles

El servidor proporciona los siguientes comandos MCP:

// Account & Workspace Management
get-accounts        // List accessible accounts
get-workspaces      // List workspaces in an account
get-queries         // Retrieve existing AI queries

// Dataset Operations
create-dataset      // Create a new dataset
get-datasets        // List datasets in a workspace
get-dataset-output  // Retrieve dataset records
get-dataset-targetfields // Retrieve dataset targetfields
upload-dataset-rows // Add new data rows to an existing dataset

// AI Operations
get-ai-context      // Get workspace AI context
execute-ai-query    // Run AI queries on datasets

Cómo seleccionar la categoría de herramienta adecuada

Para operaciones de solo lectura : utilice la configuración del servidor consume.js
Para crear conjuntos de datos : utilice la configuración del servidor design.js
Para cargar datos : utilice la configuración del servidor manage.js

Consideraciones de seguridad

Se requiere autenticación mediante clave API
La validación de solicitudes garantiza que los datos tengan el formato correcto

Desarrollo

El código base está escrito en TypeScript y organizado en:

Manipuladores de herramientas : Implementación de la funcionalidad de cada herramienta
Capa de transporte : gestiona la comunicación con el modelo de IA
Validación : garantiza formatos de datos adecuados utilizando esquemas Zod

Depuración

El servidor MCP se comunica mediante stdio, lo que puede dificultar la depuración. Ofrecemos una herramienta de inspección MCP para ayudar a:

npm run inspector

Esto proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Contribuyendo

¡Agradecemos tus contribuciones! No dudes en enviar una solicitud de incorporación de cambios.

Licencia

Archivo de LICENCIA para más detalles

Apoyo

Documentación: Verodat Docs
Problemas: Problemas de GitHub
Comunidad: Comunidad Verodat

Verodat MCP Server

Integrations

Servidor Verodat MCP

Descripción general

Servidor Verodat MCP

Descripción general

Categorías de herramientas

1. Consumir (8 herramientas)

2. Diseño (9 herramientas)

3. Administrar (10 herramientas)

Prerrequisitos

Instalación

Inicio rápido

Instalación mediante herrería

Instalación manual

Introducción a Verodat

Configuración

Opciones de configuración

Variables de entorno

Guía de uso de herramientas

Comandos disponibles

Cómo seleccionar la categoría de herramienta adecuada

Consideraciones de seguridad

Desarrollo

Depuración

Contribuyendo

Licencia

Apoyo

Related Resources