Claude 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, a la vez que gestiona 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

Related MCP server: Advanced Trello MCP Server

Herramientas disponibles

trello_get_cards_by_list

Recupera una lista de tarjetas contenidas en el ID de lista especificado.

{
  name: "trello_get_cards_by_list",
  arguments: {
    listId: string; // Trello list ID
  }
}

trello_get_lists

Recupera todas las listas del tablero.

{
  name: "trello_get_lists",
  arguments: {}
}

trello_get_recent_activity

Recupera la actividad más reciente del tablero. El argumento limit puede especificar cuántas se recuperarán (predeterminado: 10).

{
  name: "trello_get_recent_activity",
  arguments: {
    limit?: number; // Optional: number of activities to retrieve
  }
}

trello_add_card

Agrega una tarjeta a la lista especificada.

{
  name: "trello_add_card",
  arguments: {
    listId: string;       // The ID of the list to add to
    name: string;         // The title of the card
    description?: string; // Optional: details of the card
    dueDate?: string;     // Optional: due date (e.g., ISO8601)
    labels?: string[];    // Optional: array of label IDs
  }
}

trello_update_card

Actualiza el contenido de una tarjeta.

{
  name: "trello_update_card",
  arguments: {
    cardId: string;       // The ID of the card to be updated
    name?: string;        // Optional: updated title
    description?: string; // Optional: updated description
    dueDate?: string;     // Optional: updated due date (e.g., ISO8601)
    labels?: string[];    // Optional: updated array of label IDs
  }
}

trello_archive_card

Archiva (cierra) la tarjeta especificada.

{
  name: "trello_archive_card",
  arguments: {
    cardId: string; // The ID of the card to archive
  }
}

trello_add_list

Agrega una nueva lista al tablero.

{
  name: "trello_add_list",
  arguments: {
    name: string; // Name of the new list
  }
}

trello_archive_list

Archiva (cierra) la lista especificada.

{
  name: "trello_archive_list",
  arguments: {
    listId: string; // The ID of the list to archive
  }
}

trello_get_my_cards

Recupera todas las tarjetas relacionadas con tu cuenta.

{
  name: "trello_get_my_cards",
  arguments: {}
}

trello_search_all_boards

Realiza una búsqueda entre todos los tableros del espacio de trabajo (organización), según el plan o los permisos.

{
  name: "trello_search_all_boards",
  arguments: {
    query: string;   // Search keyword
    limit?: number;  // Optional: max number of results (default: 10)
  }
}

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

1. Clonar el repositorio:

   git clone https://github.com/hrs-asano/claude-mcp-trello.git
   cd claude-mcp-trello

2. Instalar dependencias:

npm install

3. Construir el proyecto:

npm run build

Ejecución de pruebas

npm test

Integración con Claude Desktop

Para integrar este servidor MCP con Claude Desktop, agregue la siguiente configuración a su archivo ~/Library/Application\ Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "trello": {
      "command": "{YOUR_NODE_PATH}", // for example: /opt/homebrew/bin/node
      "args": [
        "{YOUR_PATH}/claude-mcp-trello/build/index.js"
      ],
      "env": {
        "TRELLO_API_KEY": "{YOUR_KEY}",
        "TRELLO_TOKEN": "{YOUR_TOKEN}",
        "TRELLO_BOARD_ID": "{YOUR_BOARD_ID}"
      }
    }
  }
}

Asegúrese de reemplazar {YOUR_NODE_PATH}, {YOUR_PATH}, {YOUR_KEY}, {YOUR_TOKEN} y {YOUR_BOARD_ID} con los valores adecuados para su entorno.

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