trello-mcp-server-by-thiago-batista by thiagojsb - MCP Server

📘 Trello Mcp Server - By Thiago Batista

Servidor MCP para integração com o Trello, desenvolvido para comunicação com LLMs compatíveis com o protocolo MCP (Model Context Protocol).

🎯 Projeto desenvolvido para fins de estudo e compreensão do MCP.

📌 Visão Geral do Projeto

Este projeto implementa ferramentas para interação com a API do Trello, utilizando o padrão ToolHandler e registro dinâmico via ToolRegistry. As funcionalidades incluem leitura, criação, atualização e exclusão de quadros, listas e cartões.

🛠️ Ferramentas MCP disponíveis

O servidor expõe as seguintes ferramentas para interação com o Trello:

Nome	Descrição	Campos obrigatórios
listar-acoes-quadro	Lista ações de um quadro específico	boardId
listar-quadros	Lista todos os quadros do usuário no Trello	(nenhum)
listar-listas-quadro	Lista todas as listas de um quadro específico	boardId
listar-cartoes-lista	Lista os cartões de uma lista específica	listId
incluir-lista	Cria uma nova lista em um quadro	boardId, listName
incluir-cartao	Cria um novo cartão em uma lista	listId, cardName
incluir-descricao-cartao	Adiciona uma descrição a um cartão	cardId, description
atualizar-lista	Atualiza o nome de uma lista	listId, newName
atualizar-cartao	Atualiza o nome de um cartão	cardId, newName
atualizar-descricao-cartao	Atualiza a descrição de um cartão	cardId, newDescription
arquivar-lista	Arquiva uma lista (reversível)	listId
arquivar-cartao	Arquiva um cartão (reversível)	cardId
excluir-lista	Exclui permanentemente uma lista	listId
excluir-cartao	Exclui permanentemente um cartão	cardId

⚙️ Requisitos de Execução

Java 17+

Para executar o servidor corretamente, é necessário informar para a LLM:

O caminho completo do .jar gerado
As secrets da API do Trello como variáveis de ambiente (ENV)

📝 Observação: A LLM geralmente possui um arquivo de configuração onde são definidos os servidores MCP e as variáveis de ambiente.

🗂️ Exemplo de configuração da LLM Claude (`claude_desktop_config.json`)

{
  "mcpServers": {
    "trello-mcp-server-by-thiago-batista": {
      "command": "java",
      "args": [
        "-jar",
        "PATH_PARA_.JAR_AQUI"
      ],
      "env": {
        "TRELLO_API_KEY": "XXXXXXXXXXXXXXXXX",
        "TRELLO_API_TOKEN": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

thiagojsb/trello-mcp-server-by-thiago-batista