Servidor MCP de ArangoDB

Esta es una implementación del Protocolo de Contexto de Modelo para ArangoDB.

Descripción general

Para rellenar.

Related MCP server: MCP Server for ArangoDB

Componentes

Recursos

Herramientas

Herramientas de consulta

• readQuery

  • Ejecutar una consulta de solo lectura en la base de datos

  • Aporte:

    • databaseName (cadena): La base de datos a consultar

    • aql (cadena): La consulta AQL de solo lectura que se ejecutará

  • Devuelve: Resultados de la consulta como una matriz de objetos

• readWriteQuery

  • Ejecutar consulta en la base de datos

  • Aporte:

    • databaseName (cadena): La base de datos a consultar

    • aql (cadena): La consulta AQL a ejecutar

  • Devuelve: Resultados de la consulta como una matriz de objetos

• listDatabases

  • Listar todas las bases de datos en el servidor ArangoDB

  • Devuelve: Matriz de nombres de bases de datos

• listCollections

  • Listar todas las colecciones en una base de datos ArangoDB

  • Aporte:

    • databaseName (cadena): El nombre de la base de datos

  • Devuelve: Matriz de objetos { "name": "<collectionName>" }

Uso

Para conectarse a una instancia de arangodb que se ejecuta en localhost:2434, a la base de datos "cuenta", agregue lo siguiente a su claude_desktop_config.json , asumiendo que la ruta a este proyecto es /home/yourcoolname/arango-mcp-server :

{
  "mcpServers": {
    "arangodb-account": {
      "command": "npx",
      "args": [
        "-y",
        "arango-mcp-server",
        "http://localhost:8529",
        "root",
        "root"
      ]
    }
  }
}

Desarrollo

Clonar el repositorio. Instalar todo. Configurar el entorno de desarrollo. Ejecutar el observador. Editar index.ts.

$ npm install
$ npm run dev:setup
$ npm run dev

Vaya a http://localhost:5173/ para ver el inspector.

Hacer

• [ ] Estudie adecuadamente la especificación para ver si la implementación actual de los recursos realmente tiene sentido (no creo que lo tenga)

  • [x] Las plantillas de recursos tienen sentido

• [ ] Cambia todo "arango" a "arangodb" (nombre del repositorio incluido...)

• [ ] Vuelva a agregar la contraseña de arangodb

• [ ] README adecuado

  • [ ] Herramientas/recursos/etc. siguiendo el formato del material oficial antrópico

• [ ] Descubra las notificaciones

• [ ] Controles de salud

• [ ] ¿Más herramientas?

• [ ] Acceder a todas las bases de datos que se ejecutan en una instancia de arangodb

• [ ] Liberarlo en npm de alguna manera para que pueda usarse con npx

• [ ] resources/subscribe y notifications/resources/list_changed y resources/unsubscribe

• [x] Documentar adecuadamente las herramientas en el archivo README

• [x] Como en el cliente SQLite MCP

  • [x] La herramienta write_query está separada de read_query -> en realidad es readWriteQuery

  • [x] list_collections (ver list_tables )

• [x] Grupo de clientes, es decir, un cliente por base de datos

• [x] Entorno de desarrollo

• [x] resources/read con una plantilla para leer cualquier documento por nombre de base de datos, colección, id.

• [x] Agregar nombre de usuario y contraseñas como parámetros del comando