GitLab Kanban

🎯 GitLab Kanban MCP Server

Um servidor de Protocolo de Contexto de Modelo (MCP) para gerenciar operações de quadro Kanban do GitLab.

✨ Recursos

🛠️ Ferramentas Disponíveis

• list_tasks - Recuperar lista de tarefas do quadro Kanban do projeto
• create_task - Criar uma nova tarefa no quadro Kanban
• update_task - Atualizar uma tarefa existente
• delete_task - Excluir uma tarefa do quadro
• add_comment - Adicionar um comentário a uma tarefa

🏗️ Estrutura do Projeto

src/
├── api/
│   └── gitlab.ts      # GitLab API client and methods
├── config/
│   └── gitlab.ts      # GitLab configuration
├── tools/
│   ├── handlers.ts    # Tool handler implementations
│   └── schemas.ts     # Tool schema definitions
└── index.ts          # MCP server main entry point

🚀 Começando

📦 Instalação

npm install

🔧 Configuração

Crie um arquivo .env com as seguintes variáveis de ambiente:

GITLAB_TOKEN=your_gitlab_token
GITLAB_URL=your_gitlab_url  # default: https://gitlab.com

🛠️ Compilação

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

🔍 Depuração

Como os servidores MCP se comunicam via stdio, recomendamos usar o MCP Inspector:

npm run inspector

📝 Uso

Configuração do Cline

Adicione o seguinte ao seu cline_mcp_settings.json:

{
  "mcpServers": {
    "gitlab-kanban-mcp-server": {
      "command": "node",
      "args": ["path/to/gitlab-kanban-mcp-server/build/index.js"],
      "env": {
        "GITLAB_TOKEN": "your_gitlab_token",
        "GITLAB_URL": "your_gitlab_url"
      }
    }
  }
}

🤝 Contribuindo

1. Faça um fork deste repositório
2. Crie sua branch de recurso (git checkout -b feature/amazing-feature)
3. Faça commit das suas alterações (git commit -m '✨ feat: Add amazing feature')
4. Envie para a branch (git push origin feature/amazing-feature)
5. Crie um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT.