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

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. 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:

• get_boards : Lista todos los tableros de Trello

• get_lists : Obtener listas de un tablero

• get_cards : Obtener tarjetas de un tablero o lista

• get_card_details : Obtener información detallada de la tarjeta

Licencia

Licencia ISC: consulte el archivo de LICENCIA para obtener más detalles