项目简介
GitLab Kanban MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现,旨在为 LLM 应用提供访问和操作 GitLab 项目看板的功能。通过此服务器,LLM 可以便捷地管理 GitLab 项目中的任务,例如查看任务列表、创建新任务、更新任务状态、删除任务以及添加评论等。
主要功能点
- 任务管理工具: 提供一系列工具,用于操作 GitLab 项目的看板任务,包括:
- 'list_tasks': 获取指定项目看板中的任务列表。
- 'create_task': 在指定项目看板中创建新任务。
- 'update_task': 更新指定项目看板中现有任务的信息(标题、描述、状态)。
- 'delete_task': 删除指定项目看板中的任务。
- 'add_comment': 为指定项目看板中的任务添加评论。
安装步骤
- 克隆仓库 (如果您还没有克隆):
git clone https://github.com/Sunwood-ai-labs/gitlab-kanban-mcp-server.git cd gitlab-kanban-mcp-server - 安装依赖:
npm install - 构建项目:
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' 定义。
信息
分类
开发者工具