Skip to main content
Glama
Sign In
enesjakozh

MCP Server for ArangoDB

by ravenwits
npmGitHub
TypeScript
MIT License
85
18
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Servidor MCP para ArangoDB

Un servidor de Protocolo de Contexto de Modelo para ArangoDB

Este es un servidor MCP basado en TypeScript que proporciona capacidades de interacción con bases de datos a través de ArangoDB. Implementa operaciones básicas de base de datos y permite una integración fluida con ArangoDB mediante herramientas MCP. Puedes usarlo con la aplicación Claude y también con extensiones para VSCode compatibles con MCP como Cline.

Características

Herramientas

  • arango_query - Ejecutar consultas AQL
    • Toma una cadena de consulta AQL como parámetro obligatorio
    • Acepta opcionalmente variables de enlace para consultas parametrizadas
    • Devuelve los resultados de la consulta como JSON
  • arango_insert - Insertar documentos en colecciones
    • Toma el nombre de la colección y el objeto del documento como parámetros obligatorios
    • Genera automáticamente la clave del documento si no se proporciona
    • Devuelve los metadatos del documento creado
  • arango_update - Actualizar documentos existentes
    • Toma el nombre de la colección, la clave del documento y el objeto de actualización como parámetros obligatorios
    • Devuelve los metadatos del documento actualizados
  • arango_remove - Eliminar documentos de colecciones
    • Toma el nombre de la colección y la clave del documento como parámetros obligatorios
    • Devuelve los metadatos del documento eliminado
  • arango_backup - Realiza una copia de seguridad de todas las colecciones en archivos JSON
    • Toma la ruta del directorio de salida como parámetro requerido
    • Crea archivos JSON para cada colección con datos actuales
    • Útil para fines de copia de seguridad y migración de datos.
  • arango_list_collections - Lista todas las colecciones en la base de datos
    • Devuelve una matriz de información de colección, incluidos nombres, identificaciones y tipos.
  • arango_create_collection - Crea una nueva colección en la base de datos
    • Toma el nombre de la colección como parámetro obligatorio
    • Opcionalmente, especifique el tipo de colección (documento o colección de borde)
    • Configurar el comportamiento de waitForSync para operaciones de escritura
    • Devuelve información de la colección, incluido el nombre, el tipo y el estado.

Instalación

Instalación mediante NPM

Para instalar arango-server globalmente a través de NPM, ejecute el siguiente comando:

npm install -g arango-server

Corriendo a través de NPX

Para ejecutar arango-server directamente sin instalación, utilice el siguiente comando:

npx arango-server

Configuración para el agente de VSCode

Para utilizar arango-server con el agente VSCode Copilot, debe tener instalado al menos VSCode 1.99.0 y seguir estos pasos:

  1. Crear o editar el archivo de configuración de MCP :
    • Configuración específica del espacio de trabajo : cree o edite el archivo .vscode/mcp.json en su espacio de trabajo.
    • Configuración específica del usuario : opcionalmente, especifique el servidor en la configuración de usuario de VS Code (mcp) para habilitar el servidor MCP en todos los espacios de trabajo.Consejo: puede consultar aquí la documentación de configuración de MCP de VSCode para obtener más detalles sobre cómo configurar el archivo de configuración.
  2. Agregue la siguiente configuración :
    { "servers": { "arango-mcp": { "type": "stdio", "command": "npx", "args": ["arango-server"], "env": { "ARANGO_URL": "http://localhost:8529", "ARANGO_DB": "v20", "ARANGO_USERNAME": "app", "ARANGO_PASSWORD": "75Sab@MYa3Dj8Fc" } } } }
  3. Inicie el servidor MCP :
    • Abra la paleta de comandos en VSCode ( Ctrl+Shift+P o Cmd+Shift+P en Mac).
    • Ejecute el comando MCP: Start Server y seleccione arango-mcp de la lista.
  4. Verificar el servidor :
    • Abra la vista Chat en VSCode y cambie al modo Agente.
    • Utilice el botón Tools para verificar que las herramientas arango-server estén disponibles.

Instalación mediante herrería

Para instalar ArangoDB para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @ravenwits/mcp-server-arangodb --client claude
Para usar con Claude Desktop

Vaya a: Settings > Developer > Edit Config o

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Ventanas: %APPDATA%/Claude/claude_desktop_config.json
Para usar con la extensión Cline VSCode

Vaya a: Cline Extension > MCP Servers > Edit Configuration o

  • MacOS: ~/Library/Application Support/Code/User/globalStorage/cline.cline/config.json
  • Windows: %APPDATA%/Code/User/globalStorage/cline.cline/config.json

Agregue la siguiente configuración a la sección mcpServers :

{ "mcpServers": { "arango": { "command": "node", "args": ["/path/to/arango-server/build/index.js"], "env": { "ARANGO_URL": "your_database_url", "ARANGO_DB": "your_database_name", "ARANGO_USERNAME": "your_username", "ARANGO_PASSWORD": "your_password" } } } }

Variables de entorno

El servidor requiere las siguientes variables de entorno:

  • ARANGO_URL - URL del servidor ArangoDB (nota: 8529 es el puerto predeterminado para ArangoDB para el desarrollo local)
  • ARANGO_DB - Nombre de la base de datos
  • ARANGO_USERNAME - Usuario de la base de datos
  • ARANGO_PASSWORD - Contraseña de la base de datos

Uso

Puedes proporcionar prácticamente cualquier indicación significativa y Claude intentará ejecutar la función apropiada.

Algunos ejemplos de indicaciones:

  • "Enumerar todas las colecciones en la base de datos"
  • "Consultar a todos los usuarios"
  • Insertar un nuevo documento con el nombre 'John Doe' y enviarlo por correo electrónico a ' john@example.com ' a la colección 'usuarios'.
  • Actualice el documento con la clave '123456' o el nombre 'Jane Doe' para cambiar la edad a 48.
  • "Crear una nueva colección llamada 'productos'"

Uso con la aplicación Claude

Demostración del uso del servidor ArangoDB MCP con la aplicación Claude

Uso con la extensión Cline VSCode

Demostración del uso del servidor ArangoDB MCP con la extensión Cline VSCode

Consultar a todos los usuarios:

{ "query": "FOR user IN users RETURN user" }

Insertar un nuevo documento:

{ "collection": "users", "document": { "name": "John Doe", "email": "john@example.com" } }

Actualizar un documento:

{ "collection": "users", "key": "123456", "update": { "name": "Jane Doe" } }

Eliminar un documento:

{ "collection": "users", "key": "123456" }

Listar todas las colecciones:

{ } // No parameters required

Colecciones de bases de datos de respaldo:

{ "outputDir": "./backup" // Specify an absolute output directory path for the backup files (optional) "collection": "users" // Specify a collection name to backup (optional) If no collection name is provided, all collections will be backed up "docLimit": 1000 // Specify the maximum number of documents to backup per collection (optional), if not provided, all documents will be backed up (not having a limit might cause timeout for large collections) }

Crear una nueva colección:

{ "name": "products", "type": "document", // "document" or "edge" (optional, defaults to "document") "waitForSync": false // Optional, defaults to false }

Nota: El servidor es independiente de la estructura de la base de datos y puede trabajar con cualquier nombre o estructura de colección siempre que sigan los modelos de colección de documentos y bordes de ArangoDB.

Descargo de responsabilidad

Solo para uso de desarrollo

Esta herramienta está diseñada únicamente para entornos de desarrollo locales. Si bien técnicamente podría conectarse a una base de datos de producción, esto generaría riesgos de seguridad significativos y se desaconseja explícitamente. La utilizamos exclusivamente con nuestras bases de datos de desarrollo para mantener la separación de tareas y proteger los datos de producción.

Desarrollo

  1. Clonar el repositorio
  2. Instalar dependencias:
    npm run build
  3. Para desarrollo con reconstrucción automática:
    npm run watch

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser un desafío. La depuración recomendada se puede realizar utilizando MCP Inspector para el desarrollo:

npm run inspector

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

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Un servidor basado en TypeScript para interactuar con ArangoDB utilizando el Protocolo de Contexto de Modelo, lo que permite operaciones de base de datos e integración con herramientas como Claude y extensiones VSCode para una gestión optimizada de datos.

  1. Características
    1. Herramientas
  2. Instalación
    1. Instalación mediante NPM
    2. Corriendo a través de NPX
    3. Configuración para el agente de VSCode
    4. Instalación mediante herrería
    5. Variables de entorno
  3. Uso
    1. Uso con la aplicación Claude
    2. Uso con la extensión Cline VSCode
  4. Descargo de responsabilidad
    1. Solo para uso de desarrollo
  5. Desarrollo
    1. Depuración
  6. Licencia

    Related Resources

    Related MCP Servers

    • MCP Server Starter

      coinselor
      A
      security
      A
      license
      A
      quality
      A production-ready template for building Model Context Protocol servers in TypeScript, offering fast development with Bun, Biome linting, and automated version management.
      Last updated -
      1
      1
      JavaScript
      MIT License

    • MCP Server Template

      stevennevins
      A
      security
      F
      license
      A
      quality
      A TypeScript-based template for developing Model Context Protocol servers with features like dependency injection and service-based architecture, facilitating the creation and integration of custom data processing tools.
      Last updated -
      1
      2
      TypeScript

    • Supabase MCP Server

      NightTrek
      A
      security
      F
      license
      A
      quality
      Enables querying Supabase databases and generating TypeScript types through the Model Context Protocol interface, supporting features like schema selection, column filtering, and pagination.
      Last updated -
      2
      9
      JavaScript
      • Apple
      • Linux

    • ArangoDB MCP Server

      lucas-deangelis
      -
      security
      A
      license
      -
      quality
      An implementation of the Model Context Protocol that enables interaction with ArangoDB databases, allowing users to perform queries, list databases and collections through natural language.
      Last updated -
      8
      3
      JavaScript
      MIT License

    View all related MCP servers

    Appeared in Searches

    New MCP Servers

    MCP directory API

    We provide all the information about MCP servers via our MCP API.

    curl -X GET 'https://glama.ai/api/mcp/v1/servers/ravenwits/mcp-server-arangodb'

    If you have feedback or need assistance with the MCP directory API, please join our Discord server