Servidor MCP de Trello (TypeScript)

Una implementación de TypeScript de un servidor de Protocolo de contexto de modelo (MCP) para la integración de Trello, que proporciona herramientas para que los asistentes de IA interactúen con tableros, listas y tarjetas de Trello.

Características

Integración completa de la API de Trello a través de herramientas MCP
Operaciones asincrónicas para un mejor rendimiento
Implementación segura de tipos usando TypeScript
Manejo integral de errores
Configuración basada en el entorno

Related MCP server: Claude MCP Trello

Prerrequisitos

Node.js 18.x o superior
npm o hilo
Credenciales de la API de Trello

Instalación

# Install dependencies
make install

Configuración

Crea un archivo .env en el directorio raíz con tus credenciales de Trello:

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

Comandos disponibles

# Install dependencies
make install

# Build the project
make build

# Start the server
make start

# Clean build artifacts
make clean

# Run linter
make lint

Herramientas MCP

obtener_tableros

Recupera todos los tableros de Trello para el usuario autenticado.

// No input parameters required

obtener_listas

Obtiene todas las listas de un tablero específico.

{
  "request": {
    "board_id": string // ID of the board
  }
}

obtener_tarjetas

Obtiene cartas de un tablero o una lista específica.

{
  "request": {
    "board_id": string,    // ID of the board
    "list_id"?: string     // Optional: ID of a specific list
  }
}

obtener_detalles_de_la_tarjeta

Recupera información detallada sobre una tarjeta específica.

{
  "request": {
    "card_id": string      // ID of the card
  }
}

Desarrollo

El proyecto utiliza TypeScript para garantizar la seguridad de tipos y una mejor experiencia del desarrollador. El código fuente está organizado de la siguiente manera:

src/index.ts - Punto de entrada del servidor principal
src/trello-client.ts - Implementación del cliente de la API de Trello
src/types.ts - Definiciones de tipos de TypeScript

Edificio

El proyecto utiliza el compilador TypeScript para construir:

# Build the project
make build

# The output will be in the build/ directory

Manejo de errores

El servidor implementa un manejo integral de errores para:

Errores de autenticación de API
Limitación de velocidad
Problemas de red
Parámetros de solicitud no válidos

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Uso con Cline

Para utilizar este servidor MCP con Cline, agregue la siguiente configuración a su archivo de configuración de MCP de Cline ( ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json ):

{
  "mcpServers": {
    "trello-ts": {
      "command": "node",
      "args": ["/path/to/mcp-server-ts-trello/build/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key",
        "TRELLO_TOKEN": "your_token"
      }
    }
  }
}

Después de agregar la configuración y reiniciar Cline, puede utilizar las siguientes herramientas MCP: