Trello MCP Server

Utiliza um quadro do Trello como base de conhecimento para armazenar e recuperar trechos de código, anotações e outras informações.

Documentação

Servidor MCP do Trello

Um servidor MCP (Model Context Protocol) que usa o Trello como base de conhecimento para armazenar e recuperar trechos de código, anotações e outras informações.

Atenção(!!)

O Claude escreveu isto. Eu não verifiquei linha por linha o que ele escreveu. Portanto, esteja ciente ao usar e faça sua própria revisão. Disponibilizo este repositório como está e não serei responsável por quaisquer danos que isso causar.

Recursos

  • Armazene trechos de código e anotações como cartões do Trello
  • Pesquise em títulos, descrições e etiquetas dos cartões
  • Organize o conhecimento por quadros e listas
  • Categorização baseada em tags usando etiquetas do Trello
  • Operações CRUD completas na sua base de conhecimento

Configuração

Pré-requisitos: Certifique-se de ter o direnv instalado para gerenciamento de variáveis de ambiente.

  1. Obtenha as credenciais da API do Trello:

    • Primeiro, crie um Power-Up em https://trello.com/power-ups/admin (necessário para acesso à API)
    • Vá até a aba "API Key" do seu Power-Up e gere uma nova chave de API
    • Gere um Token clicando no link Token (está oculto no texto)
    • Copie tanto sua Chave de API quanto seu Token
  2. Crie um Quadro de Conhecimento:

    • Crie um novo quadro no Trello para sua base de conhecimento
    • Crie listas como "Trechos de Código", "Configuração", "Anotações", etc.
    • Copie o ID do quadro a partir da URL
  3. Configure o ambiente com direnv:

    # Edit .envrc with your Trello credentials
    # Make sure direnv is installed and allowed for this directory
    direnv allow
    
  4. Instale e execute:

    npm install
    npm start
    
  5. Configure o Claude Desktop: Adicione isto ao seu arquivo de configuração do Claude Desktop:

    macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

    {
      "mcpServers": {
        "trello-knowledge": {
          "command": "node",
          "args": ["src/index.js"],
          "cwd": "/path/to/your/trello-mcp-server",
          "env": {
            "TRELLO_API_KEY": "your_api_key_here",
            "TRELLO_TOKEN": "your_token_here",
            "TRELLO_KNOWLEDGE_BOARD_ID": "your_board_id_here"
          }
        }
      }
    }
    

    Windows PowerShell (se o Node.js não estiver no PATH):

    {
      "mcpServers": {
        "trello-knowledge": {
          "command": "C:\\Program Files\\nodejs\\node.exe",
          "args": ["C:\\Users\\YourUsername\\path\\to\\trello-mcp-server\\src\\index.js"],
          "env": {
            "TRELLO_API_KEY": "your_api_key_here",
            "TRELLO_TOKEN": "your_token_here",
            "TRELLO_KNOWLEDGE_BOARD_ID": "your_board_id_here"
          }
        }
      }
    }
    

    Alternativa com direnv (se você quiser que o Claude Desktop herde o ambiente do seu shell):

    {
      "mcpServers": {
        "trello-knowledge": {
          "command": "bash",
          "args": ["-c", "cd /path/to/your/trello-mcp-server && eval \"$(direnv export bash)\" && node src/index.js"],
          "cwd": "/path/to/your/trello-mcp-server"
        }
      }
    }
    
  6. Reinicie o Claude Desktop para que as alterações tenham efeito.

Uso

Uma vez conectado ao Claude Desktop, você pode:

  • Armazenar conhecimento: "Lembre-se de que no Symfony, para embelezar respostas JSON, eu uso..."
  • Recuperar conhecimento: "Como eu lidei com respostas JSON no Symfony?"
  • Pesquisar: "Mostre-me todos os meus trechos relacionados a Docker"
  • Organizar: Os cartões são automaticamente etiquetados e categorizados

Ferramentas MCP Disponíveis

  • store_knowledge - Salvar uma nova informação
  • search_knowledge - Encontrar informações existentes
  • get_knowledge - Recuperar conhecimento específico por ID
  • list_topics - Mostrar todos os tópicos/categorias disponíveis

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.