NeuroForge1/genia-mcp-server-trello
If you are the rightful owner of genia-mcp-server-trello and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server for Trello that enables GENIA to interact with Trello boards, lists, cards, and other resources.
Trello MCP Server para GENIA
Un servidor MCP (Model Context Protocol) para Trello que permite a GENIA interactuar con tableros, listas, tarjetas y otros recursos de Trello.
Características
- Autenticación con API Key y Token de Trello
- Operaciones completas sobre tableros, listas y tarjetas
- Gestión de etiquetas y adjuntos
- Integración con el orquestador MCP de GENIA
- Soporte para autenticación por usuario
Requisitos
- Node.js 16+
- NPX
- API Key y Token de Trello con los permisos adecuados
Instalación
Usando NPX
npx @delorenj/mcp-server-trello@latest
Ejecución
TRELLO_API_KEY=your_api_key TRELLO_TOKEN=your_token npx @delorenj/mcp-server-trello@latest
Operaciones Soportadas
Tableros
get_boards
: Lista los tableros del usuarioget_board
: Obtiene información de un tablero específicocreate_board
: Crea un nuevo tableroupdate_board
: Actualiza la configuración de un tablerodelete_board
: Elimina un tablero
Listas
get_lists
: Obtiene las listas de un tableroget_list
: Obtiene información de una lista específicacreate_list
: Crea una nueva lista en un tableroupdate_list
: Actualiza una listaarchive_list
: Archiva una lista
Tarjetas
get_cards_by_list_id
: Obtiene las tarjetas de una listaget_card
: Obtiene información de una tarjeta específicaadd_card_to_list
: Añade una nueva tarjeta a una listaupdate_card
: Actualiza una tarjetamove_card
: Mueve una tarjeta entre listasarchive_card
: Archiva una tarjeta
Etiquetas y Adjuntos
add_label_to_card
: Añade una etiqueta a una tarjetaremove_label_from_card
: Elimina una etiqueta de una tarjetaadd_attachment_to_card
: Añade un adjunto a una tarjetaremove_attachment_from_card
: Elimina un adjunto de una tarjeta
Integración con GENIA
Este servidor MCP está diseñado para integrarse con el orquestador MCP de GENIA, permitiendo que los usuarios conecten sus propias cuentas de Trello y ejecuten operaciones a través de la interfaz unificada de GENIA.
Ejemplo de Configuración en el Orquestador
orchestrator.register_server(
name="trello",
command=["npx", "@delorenj/mcp-server-trello@latest"],
env_vars={
"TRELLO_API_KEY": "${TRELLO_API_KEY}",
"TRELLO_TOKEN": "${TRELLO_TOKEN}"
}
)
Manejo de Errores
El servidor incluye manejo robusto de errores para:
- Credenciales inválidas o expiradas
- Permisos insuficientes
- Límites de API excedidos
- Recursos no encontrados
- Errores de formato en solicitudes
Cada error incluye un código específico y un mensaje descriptivo para facilitar la depuración.
Verificación de Dependencias
El servidor verifica automáticamente todas las dependencias necesarias al iniciar:
- Versión de Node.js
- Disponibilidad de NPX
- Validez de las credenciales de Trello
- Conectividad con la API de Trello
Si alguna dependencia falta o es incompatible, el servidor proporcionará instrucciones claras para resolverlo.
Desarrollo
Requisitos
- Node.js 16+
- npm o yarn
Instalación de Dependencias
npm install
Compilación
npm run build
Pruebas
npm test
Licencia
MIT
Autor
GENIA Team