A
security-
licenseA
qualityEnables interaction with Trello boards, lists, and cards through Model Context Protocol (MCP) tools, leveraging TypeScript for type safety and asynchronous operations.
Last updated -
1
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.3.0
Se agregaron capacidades de gestión de tablero y espacio de trabajo:
list_boards- Lista todos los tableros a los que el usuario tiene accesoset_active_board- Establece el tablero activo para futuras operacioneslist_workspaces- Enumera todos los espacios de trabajo a los que el usuario tiene accesoset_active_workspace- Establece el espacio de trabajo activo para futuras operacioneslist_boards_in_workspace: enumera todos los tableros en un espacio de trabajo específicoget_active_board_info- Obtener información sobre el tablero actualmente activo
Se agregó almacenamiento de configuración persistente para recordar el tablero/espacio de trabajo activo
Manejo de errores mejorado para todas las operaciones nuevas
0.2.1
Se agregaron comentarios JSDoc detallados a las funciones del limitador de velocidad.
Manejo de errores mejorado para la funcionalidad de adjuntar imágenes
Documentación actualizada para la herramienta adjuntar imagen a tarjeta
0.2.0
Se agregó la herramienta
attach_image_to_cardpara adjuntar imágenes a tarjetas desde URLSe agregó compatibilidad con Docker con compilación de múltiples etapas
Seguridad mejorada al mover las variables de entorno a
.envSe agregó la configuración de Docker Compose
Se agregó
.env.templatepara una configuración más sencilla
0.1.1
Se agregó la herramienta
move_cardpara mover tarjetas entre listasDocumentació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
Selección dinámica de tableros : cambia entre tableros y espacios de trabajo sin reiniciar
Instalación
Instalación de Docker (recomendada)
La forma más sencilla de ejecutar el servidor es usando Docker:
Clonar el repositorio:
git clone https://github.com/delorenj/mcp-server-trello
cd mcp-server-trello
Copia la plantilla de entorno y completa tus credenciales de Trello:
cp .env.template .env
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
Variables de entorno
El servidor se puede configurar mediante variables de entorno. Cree un archivo .env en el directorio raíz con las siguientes variables:
# Required: Your Trello API credentials
TRELLO_API_KEY=your-api-key
TRELLO_TOKEN=your-token
# Required: Initial board ID (can be changed later using set_active_board)
TRELLO_BOARD_ID=your-board-id
# Optional: Initial workspace ID (can be changed later using set_active_workspace)
TRELLO_WORKSPACE_ID=your-workspace-id
Puedes obtener estos valores de:
Clave API: https://trello.com/app-key
Token: Generar usando su clave API
ID del tablero: se encuentra en la URL del tablero (por ejemplo, https://trello.com/b/BOARD\_ID/board-name )
ID del espacio de trabajo: se encuentra en la configuración del espacio de trabajo o mediante la herramienta
list_workspaces
Gestión de tableros y espacios de trabajo
A partir de la versión 0.3.0, el servidor MCP admite la selección dinámica de tablero y espacio de trabajo:
El
TRELLO_BOARD_IDen su archivo.envse utiliza como el ID del tablero inicial cuando se inicia el servidorPuede cambiar el tablero activo en cualquier momento utilizando la herramienta
set_active_boardEl tablero seleccionado persiste entre reinicios del servidor (almacenado en
~/.trello-mcp/config.json)De manera similar, puede configurar y conservar un espacio de trabajo activo utilizando
set_active_workspace
Esto le permite trabajar con múltiples tableros y espacios de trabajo sin reiniciar el servidor ni cambiar las variables de entorno.
Ejemplo de flujo de trabajo
Comience enumerando los tableros disponibles:
{
name: 'list_boards',
arguments: {}
}
Configura tu tablero activo:
{
name: 'set_active_board',
arguments: {
boardId: "abc123" // ID from list_boards response
}
}
Enumere los espacios de trabajo si es necesario:
{
name: 'list_workspaces',
arguments: {}
}
Establezca un espacio de trabajo activo si es necesario:
{
name: 'set_active_workspace',
arguments: {
workspaceId: "xyz789" // ID from list_workspaces response
}
}
Consulte la información actual del tablero activo:
{
name: 'get_active_board_info',
arguments: {}
}
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 actualmente activo.
{
name: 'get_lists',
arguments: {}
}
obtener_actividad_reciente
Obtener la actividad reciente en el tablero actualmente activo.
{
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 actualmente activo.
{
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
}
}
adjuntar imagen a la tarjeta
Adjunte una imagen a una tarjeta directamente desde una URL.
{
name: 'attach_image_to_card',
arguments: {
cardId: string, // ID of the card to attach the image to
imageUrl: string, // URL of the image to attach
name?: string // Optional: Name for the attachment (defaults to "Image Attachment")
}
}
tableros de listas
Enumere todos los tableros a los que el usuario tiene acceso.
{
name: 'list_boards',
arguments: {}
}
establecer_tablero_activo
Establecer el tablero activo para futuras operaciones.
{
name: 'set_active_board',
arguments: {
boardId: string // ID of the board to set as active
}
}
lista_espacios_de_trabajo
Enumere todos los espacios de trabajo a los que el usuario tiene acceso.
{
name: 'list_workspaces',
arguments: {}
}
establecer_espacio_de_trabajo_activo
Establecer el espacio de trabajo activo para operaciones futuras.
{
name: 'set_active_workspace',
arguments: {
workspaceId: string // ID of the workspace to set as active
}
}
tableros de listas en el espacio de trabajo
Enumere todos los tableros en un espacio de trabajo específico.
{
name: 'list_boards_in_workspace',
arguments: {
workspaceId: string // ID of the workspace to list boards from
}
}
obtener_información_del_tablero_activo
Obtenga información sobre el tablero actualmente activo.
{
name: 'get_active_board_info',
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/delorenj/mcp-server-trello
cd mcp-server-trello
Instalar dependencias
npm install
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
Creado con el SDK del protocolo de contexto de modelo
Utiliza la API REST de Trello
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.
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.
- Registro de cambios
- Características
- Instalación
- Configuración
- Herramientas disponibles
- obtener_tarjetas_por_id_de_lista
- obtener_listas
- obtener_actividad_reciente
- añadir tarjeta a la lista
- actualizar_detalles_de_la_tarjeta
- tarjeta de archivo
- añadir_lista_al_tablero
- lista de archivo
- obtener_mis_tarjetas
- mover_tarjeta
- adjuntar imagen a la tarjeta
- tableros de listas
- establecer_tablero_activo
- lista_espacios_de_trabajo
- establecer_espacio_de_trabajo_activo
- tableros de listas en el espacio de trabajo
- obtener_información_del_tablero_activo
- Limitación de velocidad
- Manejo de errores
- Desarrollo
- Contribuyendo
- Licencia
- Expresiones de gratitud
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityA Model Context Protocol server that provides tools for interacting with Trello boards, enabling seamless management of cards, lists, and activities while handling rate limiting and type safety.Last updated -12MIT License
- Asecurity-licenseAqualityConnects to Trello with all the tools available that I was able to find in API referenceLast updated -151218MIT License
- Asecurity-licenseAqualityEnables seamless integration with Trello boards, allowing users to manage cards, lists, and activities while automatically handling rate limiting and providing type safety.Last updated -9MIT License