GitLab看板MCP服务器
一种模型上下文协议服务器,通过列出、创建、更新和删除任务的工具,以及添加评论的功能,实现对GitLab看板的管理。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"gitlab-kanban-mcp-server": {
"args": [
"path/to/gitlab-kanban-mcp-server/build/index.js"
],
"command": "node",
"env": {
"GITLAB_TOKEN": "your_gitlab_token",
"GITLAB_URL": "your_gitlab_url"
}
}
}
}
该服务需要配置环境变量:GITLAB_TOKEN、GITLAB_URL
可用工具 (5 个)
该服务在 MCP 协议中暴露的工具,AI 可按需调用
list_tasks 1 个参数 需填 1 项
プロジェクトのカンバンボードのタスク一覧を取得
必填参数:projectId
create_task 4 个参数 需填 2 项
カンバンボードに新しいタスクを作成
必填参数:projectId、title
update_task 5 个参数 需填 2 项
カンバンボードのタスクを更新
必填参数:projectId、issueId
delete_task 2 个参数 需填 2 项
カンバンボードのタスクを削除
必填参数:projectId、issueId
add_comment 3 个参数 需填 3 项
タスクにコメントを追加
必填参数:projectId、issueId、body
服务介绍
🎯 GitLab Kanban MCP 服务器
一个用于管理 GitLab 看板操作的模型上下文协议(Model Context Protocol, MCP)服务器。
✨ 功能
🛠️ 可用工具
list_tasks- 从项目的看板中检索任务列表create_task- 在看板上创建新任务update_task- 更新现有任务delete_task- 从看板中删除任务add_comment- 向任务添加评论
🏗️ 项目结构
src/
├── api/
│ └── gitlab.ts # GitLab API client and methods
├── config/
│ └── gitlab.ts # GitLab configuration
├── tools/
│ ├── handlers.ts # Tool handler implementations
│ └── schemas.ts # Tool schema definitions
└── index.ts # MCP server main entry point
🚀 开始使用
📦 安装
npm install
🔧 配置
创建一个 .env 文件,并包含以下环境变量:
GITLAB_TOKEN=your_gitlab_token
GITLAB_URL=your_gitlab_url # default: https://gitlab.com
🛠️ 构建
npm run build
对于开发时自动重建:
npm run watch
🔍 调试
由于 MCP 服务器通过标准输入输出进行通信,我们建议使用 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"
}
}
}
}
🤝 贡献
- 分叉此仓库
- 创建你的功能分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m '✨ feat: 添加令人惊叹的功能') - 推送到分支 (
git push origin feature/amazing-feature) - 创建拉取请求
📄 许可证
本项目根据 MIT 许可证发布。