Edgee MCP Server

Administrar organizaciones, proyectos, componentes y usuarios a través de la API de Edgee.

Documentación

Servidor MCP para la API de Edgee, que permite la gestión de organizaciones, operaciones de proyectos, administración de componentes y gestión de usuarios a través del Protocolo de Contexto de Modelos (MCP).

Características

  • Gestión de Organizaciones: Crear, leer, actualizar y eliminar organizaciones
  • Operaciones de Proyectos: Gestionar proyectos, dominios, componentes y estadísticas
  • Administración de Componentes: Trabajar con componentes, versiones y configuraciones
  • Gestión de Usuarios: Administrar usuarios, invitaciones y tokens de API
  • Manejo Integral de Errores: Mensajes de error claros para problemas comunes
  • API Segura por Tipos: Construida con TypeScript para una verificación de tipos robusta

Herramientas

Herramientas de Organización

  • edgee-listOrganizations: Listar todas las organizaciones con filtrado opcional
  • edgee-getMyOrganization: Obtener tu organización personal
  • edgee-getOrganization: Obtener una organización por ID
  • edgee-createOrganization: Crear una nueva organización
  • edgee-updateOrganization: Actualizar una organización existente
  • edgee-deleteOrganization: Eliminar una organización
  • edgee-listOrganizationUsers: Listar usuarios de una organización

Herramientas de Proyectos

  • edgee-listProjects: Listar todos los proyectos con filtrado opcional
  • edgee-getProject: Obtener un proyecto por ID
  • edgee-createProject: Crear un nuevo proyecto
  • edgee-updateProject: Actualizar un proyecto existente
  • edgee-deleteProject: Eliminar un proyecto
  • edgee-getProjectCounters: Obtener estadísticas de un proyecto
  • edgee-listProjectDomains: Listar dominios de un proyecto
  • edgee-createProjectDomain: Crear un nuevo dominio para un proyecto
  • edgee-listProjectComponents: Listar componentes de un proyecto

Herramientas de Componentes

  • edgee-listPublicComponents: Listar todos los componentes públicos
  • edgee-listOrganizationComponents: Listar componentes de una organización
  • edgee-getComponentByUuid: Obtener un componente por UUID
  • edgee-getComponentBySlug: Obtener un componente por slug
  • edgee-createComponent: Crear un nuevo componente
  • edgee-createComponentVersion: Crear una nueva versión de componente

Herramientas de Usuario

  • edgee-getMe: Obtener el usuario actual
  • edgee-getUser: Obtener un usuario por ID
  • edgee-listInvitations: Listar todas las invitaciones
  • edgee-createInvitation: Crear una nueva invitación
  • edgee-deleteInvitation: Eliminar una invitación
  • edgee-listApiTokens: Listar todos los tokens de API
  • edgee-createApiToken: Crear un nuevo token de API
  • edgee-deleteApiToken: Eliminar un token de API
  • edgee-getUploadPresignedUrl: Obtener una URL prefirmada para subir archivos

Configuración

Token de Acceso Personal

Crea un Token de Acceso Personal de Edgee:

  • Ve a Tokens de API (en Configuración de la Cuenta > Tokens de API)
  • Crea un token
    • Asigna un nombre a este token
    • Selecciona un período de validez para el token que vas a crear. Si no se selecciona una duración, el token nunca expirará.
  • Copia el token generado

Instalación

Puedes usar este servidor MCP de varias maneras:

NPX (Recomendado)

npx @edgee/mcp-server-edgee

Instalación Global

npm install -g @edgee/mcp-server-edgee

Instalación Local

npm install @edgee/mcp-server-edgee

Uso con Claude Desktop

Para usar esto con Claude Desktop, agrega lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "edgee": {
      "command": "npx",
      "args": [
        "-y",
        "@edgee/mcp-server-edgee"
      ],
      "env": {
        "EDGEE_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Ejemplos

Listar Organizaciones

Use the edgee-listOrganizations tool to list all your organizations.

Crear un Proyecto

Use the edgee-createProject tool to create a new project with the following parameters:
- organization_id: "org_123456"
- slug: "my-new-project"
- description: "This is my new project"

Obtener Componentes de un Proyecto

Use the edgee-listProjectComponents tool to list all components for project "proj_123456".

Crear una Invitación

Use the edgee-createInvitation tool to invite a user to your organization:
- organization_id: "org_123456"
- email: "user@example.com"
- role: "member"

Desarrollo

Compilar desde el Código Fuente

git clone https://github.com/edgee-cloud/mcp-server-edgee.git
cd mcp-server-edgee
npm install
npm run build

Licencia

Apache-2.0