<div align="center"> <img src="assets/header.svg" alt="GitLab Kanban MCP" width="800">

<div> <a href="README.md"><img src="https://img.shields.io/badge/english-document-white.svg" alt="EN doc"></a> <a href="README.ja.md"><img src="https://img.shields.io/badge/ドキュメント-日本語-white.svg" alt="JA doc"/></a> </div>

<div> <a href="https://gitlab.com"><img src="https://img.shields.io/badge/GitLab-FC6D26?style=for-the-badge&logo=gitlab&logoColor=white" alt="GitLab"></a> <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript"></a> <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node.js"></a> <a href="https://github.com/modelcontextprotocol/sdk"><img src="https://img.shields.io/badge/MCP_SDK-0.6.0-blue?style=for-the-badge" alt="MCP SDK"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="MIT License"></a> </div> </div>

🎯 GitLab Kanban MCP 服务器

用于管理 GitLab Kanban 看板操作的模型上下文协议服务器。

✨ 功能

🛠️ 可用工具

• list_tasks - 从项目的 Kanban 看板检索任务列表
• create_task - 在 Kanban 看板上创建一个新任务
• update_task - 更新现有任务
• delete_task - 从看板中删除任务
• add_comment - 向任务添加评论

🏗️ 项目结构

src/
├── api/
│   └── gitlab.ts      # GitLab API 客户端和方法
├── config/
│   └── gitlab.ts      # GitLab 配置
├── tools/
│   ├── handlers.ts    # 工具处理程序实现
│   └── schemas.ts     # 工具模式定义
└── index.ts          # MCP 服务器主入口点

🚀 快速开始

📦 安装

npm install

🔧 配置

创建一个包含以下环境变量的 .env 文件：

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

🛠️ 构建

npm run build

对于具有自动重建功能的开发：

npm run watch

🔍 调试

由于 MCP 服务器通过 stdio 进行通信，我们建议使用 MCP Inspector：

npm run inspector

📝 用法

Cline 配置

将以下内容添加到您的 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. Fork 这个仓库
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 许可证获得许可。