Gitlab Kanban

🚀 GitLab Kanban MCP Server

A Model Context Protocol (MCP) server for managing GitLab Kanban board operations. It simplifies the process of interacting with GitLab Kanban boards, providing a set of useful tools to handle tasks efficiently.

✨ Features

🛠️ Available Tools

• list_tasks - Retrieve the task list of a project's Kanban board.
• create_task - Create a new task on the Kanban board.
• update_task - Update an existing task.
• delete_task - Delete a task from the Kanban board.
• add_comment - Add a comment to a task.

🏗️ Project Structure

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

🚀 Quick Start

📦 Installation

npm install

🔧 Configuration

Create a .env file and add the following environment variables:

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

🛠️ Build

npm run build

For automatic rebuilding during development:

npm run watch

🔍 Debugging

Since the MCP server communicates via standard input and output, we recommend using the MCP Inspector:

npm run inspector

📝 Usage Instructions

Console Configuration

Add the following content to your cline_mcp_settings.json file:

{
  "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"
      }
    }
  }
}

🤝 Contribution

1. Fork this repository.
2. Create your feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m '✨ feat: Add amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Create a Pull Request.

📄 License

This project is licensed under the MIT License.