项目简介

GitLab Kanban MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现,旨在为 LLM 应用提供访问和操作 GitLab 项目看板的功能。通过此服务器,LLM 可以便捷地管理 GitLab 项目中的任务,例如查看任务列表、创建新任务、更新任务状态、删除任务以及添加评论等。

主要功能点

  • 任务管理工具: 提供一系列工具,用于操作 GitLab 项目的看板任务,包括:
    • 'list_tasks': 获取指定项目看板中的任务列表。
    • 'create_task': 在指定项目看板中创建新任务。
    • 'update_task': 更新指定项目看板中现有任务的信息(标题、描述、状态)。
    • 'delete_task': 删除指定项目看板中的任务。
    • 'add_comment': 为指定项目看板中的任务添加评论。

安装步骤

  1. 克隆仓库 (如果您还没有克隆):
    git clone https://github.com/Sunwood-ai-labs/gitlab-kanban-mcp-server.git
    cd gitlab-kanban-mcp-server
  2. 安装依赖:
    npm install
  3. 构建项目:
    npm run build

服务器配置

要将此 MCP 服务器与 MCP 客户端(如 Cline)连接,您需要在客户端的 MCP 配置中添加服务器信息。以下是一个 '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"
      }
    }
  }
}

配置参数说明:

  • server name: 'gitlab-kanban-mcp-server' - 服务器的名称,可以自定义。
  • command: 'node' - 启动服务器的命令,这里使用 Node.js 运行 JavaScript 代码。
  • args: '["/path/to/gitlab-kanban-mcp-server/build/index.js"]' - 启动命令的参数,指向编译后的服务器入口文件 'index.js' 的绝对路径。请务必替换 '/path/to/gitlab-kanban-mcp-server' 为您本地仓库的实际路径。
  • env: 环境变量配置,用于服务器运行时读取:
    • 'GITLAB_TOKEN': 您的 GitLab Personal Access Token,必须配置,用于 API 鉴权。您需要在 GitLab 中生成具有 'api' 权限的 Personal Access Token。
    • 'GITLAB_URL': 您的 GitLab 实例 URL,可选配置,默认为 'https://gitlab.com'。如果使用私有部署的 GitLab 实例,请修改此配置。

请注意: 您需要将 'your_gitlab_token' 和 '/path/to/gitlab-kanban-mcp-server/build/index.js' 替换为您的实际信息。

基本使用方法

配置完成后,MCP 客户端将能够连接到此 GitLab Kanban MCP 服务器。您可以通过客户端提供的界面或指令,调用服务器提供的工具,例如:

  • 使用 'list_tasks' 工具列出指定 GitLab 项目的任务。
  • 使用 'create_task' 工具在 GitLab 项目中创建新的看板任务。
  • ... 等等。

具体工具的使用方法和参数,请参考 MCP 客户端的文档和工具的 'inputSchema' 定义。

信息

分类

开发者工具