Gitlab Kanban

🚀 GitLab 看板 MCP 服務器

本項目是一個用於管理 GitLab 看板操作的模型上下文協議（Model Context Protocol）服務器，可幫助用戶便捷地對 GitLab 看板任務進行增刪改查等操作。

🚀 快速開始

📦 安裝

npm install

🔧 配置

創建一個 .env 文件，並添加以下環境變量：

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

🛠️ 構建

npm run build

開發時使用自動重建：

npm run watch

✨ 主要特性

🛠️ 可用工具

• list_tasks - 獲取項目看板的任務列表
• create_task - 在看板上創建新任務
• update_task - 更新現有任務
• delete_task - 從看板刪除任務
• add_comment - 向任務添加評論

🏗️ 項目結構

src/
├── api/
│   └── gitlab.ts      # GitLab API 客戶端和方法
├── config/
│   └── gitlab.ts      # GitLab 配置
├── tools/
│   ├── handlers.ts    # 工具處理程序實現
│   └── schemas.ts     # 工具模式定義
└── index.ts          # MCP 服務器主入口點

🔍 調試

由於 MCP 服務器通過標準輸入輸出進行通信，我們建議使用 MCP 檢查器：

npm run inspector

💻 使用示例

控制檯配置

將以下內容添加到你的 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"
      }
    }
  }
}

🤝 貢獻

1. 叉擊此倉庫
2. 創建你的功能分支（git checkout -b feature/amazing-feature）
3. 提交你的更改（git commit -m '✨ feat: Add amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 創建 Pull Request

📄 許可證

此項目採用 MIT License 許可證。