Servidor MCP Trello

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para interactuar con los tableros de Trello. Este servidor permite una integración fluida con la API de Trello, gestionando automáticamente la limitación de velocidad, la seguridad de tipos y la gestión de errores.

Características

Integración completa con el tablero de Trello : interactúa con tarjetas, listas y actividades del tablero
Limitación de velocidad incorporada : respeta los límites de la API de Trello (300 solicitudes/10 s por clave de API, 100 solicitudes/10 s por token)
Implementación de tipo seguro : escrita en TypeScript con definiciones de tipo completas
Validación de entrada : validación robusta para todas las entradas de API
Manejo de errores : Manejo de errores elegante con mensajes informativos

Instalación

npm install @modelcontextprotocol/mcp-server-trello

Configuración

Agregue el servidor a su archivo de configuración de MCP con la siguiente configuración:

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token",
        "TRELLO_BOARD_ID": "your-board-id"
      }
    }
  }
}

Variables de entorno requeridas

TRELLO_API_KEY : Su clave API de Trello (obténgala en https://trello.com/app-key )
TRELLO_TOKEN : Su token de Trello (generado usando su clave API)
TRELLO_BOARD_ID : ID del tablero de Trello con el que interactuar (se encuentra en la URL del tablero)

Herramientas disponibles

obtener_tarjetas_por_id_de_lista

Obtener todas las tarjetas de una lista específica.

{
  name: 'get_cards_by_list_id',
  arguments: {
    listId: string  // ID of the Trello list
  }
}

obtener_listas

Recuperar todas las listas del tablero configurado.

{
  name: 'get_lists',
  arguments: {}
}

obtener_actividad_reciente

Obtener la actividad reciente en el tablero.

{
  name: 'get_recent_activity',
  arguments: {
    limit?: number  // Optional: Number of activities to fetch (default: 10)
  }
}

añadir tarjeta a la lista

Agregar una nueva tarjeta a una lista especificada.

{
  name: 'add_card_to_list',
  arguments: {
    listId: string,       // ID of the list to add the card to
    name: string,         // Name of the card
    description?: string, // Optional: Description of the card
    dueDate?: string,    // Optional: Due date (ISO 8601 format)
    labels?: string[]    // Optional: Array of label IDs
  }
}

actualizar_detalles_de_la_tarjeta

Actualizar los detalles de una tarjeta existente.

{
  name: 'update_card_details',
  arguments: {
    cardId: string,       // ID of the card to update
    name?: string,        // Optional: New name for the card
    description?: string, // Optional: New description
    dueDate?: string,    // Optional: New due date (ISO 8601 format)
    labels?: string[]    // Optional: New array of label IDs
  }
}

tarjeta de archivo

Envía una tarjeta al archivo.

{
  name: 'archive_card',
  arguments: {
    cardId: string  // ID of the card to archive
  }
}

añadir_lista_al_tablero

Añade una nueva lista al tablero.

{
  name: 'add_list_to_board',
  arguments: {
    name: string  // Name of the new list
  }
}

lista de archivo

Enviar una lista al archivo.

{
  name: 'archive_list',
  arguments: {
    listId: string  // ID of the list to archive
  }
}

obtener_mis_tarjetas

Obtener todas las tarjetas asignadas al usuario actual.

{
  name: 'get_my_cards',
  arguments: {}
}

Limitación de velocidad

El servidor implementa un algoritmo de depósito de tokens para limitar la velocidad para cumplir con los límites de la API de Trello:

300 solicitudes cada 10 segundos por clave API
100 solicitudes cada 10 segundos por token

La limitación de velocidad se gestiona de forma automática y las solicitudes se pondrán en cola si se alcanzan los límites.

Manejo de errores

El servidor proporciona mensajes de error detallados para varios escenarios:

Parámetros de entrada no válidos
Límite de velocidad excedido
Errores de autenticación de API
Problemas de red
Identificaciones de tablero/lista/tarjeta no válidas

Desarrollo

Prerrequisitos

Node.js 16 o superior
npm o hilo

Configuración

Clonar el repositorio

git clone https://github.com/modelcontextprotocol/server-trello.git
cd server-trello

Instalar dependencias

npm install

Construir el proyecto

npm run build

Ejecución de pruebas

npm test

Contribuyendo

¡Agradecemos sus contribuciones! Lea nuestra Guía de Contribución para obtener más información sobre nuestro código de conducta y el proceso para enviar solicitudes de incorporación de cambios.

Licencia

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

Expresiones de gratitud

Creado con el SDK del Protocolo de Contexto de Modelo
Utiliza la API REST de Trello

MCP Server Trello

Integrations