git clone <repository-url>
cd gitlab-mcp-server

npm install

cp .env.example .env

# GitLab Personal Access Token（必填）
GITLAB_TOKEN=你的GitLab访问令牌

# GitLab 实例地址（可选，默认使用 gitlab.com）
GITLAB_HOST=https://gitlab.com

npm start

{
  "mcpServers": {
    "gitlab": {
      "command": "node",
      "args": ["/path/to/gitlab-mcp-server/src/index.js"],
      "env": {
        "GITLAB_TOKEN": "你的GitLab访问令牌"
      }
    }
  }
}

// 可用工具: create_gitlab_repository
// 参数: name (必填), description (可选), visibility (可选)

// 可用工具: list_gitlab_projects
// 参数: per_page (可选), page (可选), visibility (可选)

// 可用工具: get_gitlab_project
// 参数: project_id (必填)

// 可用工具: create_gitlab_branch
// 参数: project_id (必填), branch_name (必填), ref (可选)

// 可用工具: delete_gitlab_project
// 参数: project_id (必填)

// 可用工具: get_gitlab_user
// 参数: 无

gitlab-mcp-server/
├── .env.example              # 环境变量模板
├── package.json              # 项目配置
├── README.md                 # 项目说明文档
├── docs/
│   └── README.md            # MCP SDK 文档（从 unpkg.com 下载）
└── src/
    ├── index.js             # MCP 服务器主入口
    └── gitlab-service.js    # GitLab API 服务封装

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  // 处理工具调用
});

// 注册资源处理器
server.setRequestHandler(ListResourcesRequestSchema, async () => {
  // 返回可用资源列表
});

// 注册提示符
server.setRequestHandler(ListPromptsRequestSchema, async () => {
  // 返回可用提示符列表
});

npm start 2> debug.log

# 确保 .env 文件中的 token 正确
cat .env

# 验证 token 是否有效
curl -H "PRIVATE-TOKEN: $GITLAB_TOKEN" https://gitlab.com/api/v4/user