返回 MCP 目录
public公开dns本地运行

GitLab Kanban

一个基于Model Context Protocol的服务器,用于管理GitLab看板任务操作,提供任务列表查询、创建、更新、删除及评论功能。

article

README

🚀 GitLab 看板 MCP 服务器

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 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端