MCP GitLab 服务器

基本能力

产品定位

MCP GitLab 服务器是一个中间件服务，旨在简化与私有GitLab实例的交互，提供标准化的API接口。

核心功能

• 提供简化的API接口访问私有GitLab实例
• 支持获取项目列表和项目详情
• 支持查看仓库文件内容
• 支持获取项目提交历史
• 支持获取和操作合并请求
• 完整的日志记录
• 跨域支持
• 支持Smithery平台部署和本地部署两种模式

适用场景

• 需要与私有GitLab实例交互的应用开发
• 需要简化GitLab API调用的场景
• 需要将GitLab功能集成到其他系统中的场景

工具列表

• smithery.yaml: 定义Smithery平台配置参数
• Dockerfile: 用于Docker容器化部署
• docker-compose.yml: 简化Docker部署流程

常见问题解答

• Smithery相关问题: 如何更新已部署在Smithery上的服务、Smithery环境变量如何配置、Smithery部署和本地部署的区别
• 本地部署相关问题: 如何添加身份验证、遇到"Error fetching projects"错误怎么办、如何获取GitLab访问令牌

使用教程

使用依赖

1. 克隆仓库 bash git clone https://github.com/yourusername/mcp-gitlab-server.git cd mcp-gitlab-server

2. 安装依赖 bash npm install

安装教程

1. 配置环境变量 bash cp .env.example .env 编辑.env文件，填入必要的配置： GITLAB_URL=https://your-gitlab-instance.com GITLAB_TOKEN=your_private_token GITLAB_API_VERSION=v4 PORT=3000 LOG_LEVEL=info

2. 启动服务 ```bash # 生产模式 npm start

# 开发模式（支持热重载） npm run dev ```

调试方式

1. 检查服务健康状态 bash curl http://localhost:3000/health

2. 测试API端点 bash curl http://localhost:3000/api/projects

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。