Skip to main content
Glama
Sign In
enesjakozh

MCP Server Trello

by delorenj
Verified
npmGitHub
TypeScript
MIT License
114
25
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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.

Integrations

  • Provides tools for interacting with Trello boards, including fetching cards and lists, adding new cards and lists, updating card details, archiving cards and lists, and fetching recent activity.

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.

Registro de cambios

0.1.2

  • Se agregó compatibilidad con Docker con compilación de múltiples etapas
  • Seguridad mejorada al mover las variables de entorno a .env
  • Se agregó la configuración de Docker Compose
  • Se agregó .env.template para una configuración más sencilla

0.1.1

  • Se agregó la herramienta move_card para mover tarjetas entre listas
  • Documentación mejorada

0.1.0

  • Versión inicial con funciones básicas de gestión de tableros de Trello

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

Instalación de Docker (recomendada)

La forma más sencilla de ejecutar el servidor es usando Docker:

  1. Clonar el repositorio:
git clone https://github.com/delorenj/mcp-server-trello cd mcp-server-trello
  1. Copia la plantilla de entorno y completa tus credenciales de Trello:
cp .env.template .env
  1. Construya y ejecute con Docker Compose:
docker compose up --build

Instalación mediante herrería

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

npx -y @smithery/cli install @modelcontextprotocol/mcp-server-trello --client claude

Instalación manual

npm install @delorenj/mcp-server-trello

Configuración

El servidor se puede configurar mediante variables de entorno. Cree un archivo .env en el directorio raíz con las siguientes variables:

TRELLO_API_KEY=your-api-key TRELLO_TOKEN=your-token TRELLO_BOARD_ID=your-board-id

Puedes obtener estos valores de:

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: {} }

mover_tarjeta

Mover una tarjeta a una lista diferente.

{ name: 'move_card', arguments: { cardId: string, // ID of the card to move listId: string // ID of the target list } }

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/delorenj/mcp-server-trello cd mcp-server-trello
  1. Instalar dependencias
npm install
  1. Construir el proyecto
npm run build

Contribuyendo

¡Las contribuciones son bienvenidas!

Licencia

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

Expresiones de gratitud

You must be authenticated.

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

Tools

View all tools

Facilita la interacción con los tableros de Trello a través de la API de Trello, ofreciendo características como limitación de velocidad, seguridad de tipos, validación de entrada y manejo de errores para una gestión fluida de tarjetas, listas y actividades del tablero.

  1. Changelog
    1. 0.1.2
    2. 0.1.1
    3. 0.1.0
  2. Features
    1. Installation
      1. Docker Installation (Recommended)
      2. Installing via Smithery
      3. Manual Installation
    2. Configuration
      1. Available Tools
        1. get_cards_by_list_id
        2. get_lists
        3. get_recent_activity
        4. add_card_to_list
        5. update_card_details
        6. archive_card
        7. add_list_to_board
        8. archive_list
        9. get_my_cards
        10. move_card
      2. Rate Limiting
        1. Error Handling
          1. Development
            1. Prerequisites
            2. Setup
          2. Contributing
            1. License
              1. Acknowledgments

                Related Resources

                Appeared in Searches

                ID: klqkamy7wt