Metadata-Version: 2.1
Name: gitlab-mcp
Version: 0.1.0
Summary: 一个用于Cursor IDE的GitLab操作服务
Home-page: https://github.com/yourusername/gitlab-mcp
Author: GitLab MCP Team
Author-email: your-email@example.com
License: UNKNOWN
Description: # GitLab MCP 服务
        
        这是一个基于Python实现的GitLab MCP（Model Control Protocol）服务，用于在Cursor IDE中提供GitLab操作支持。
        
        ## 项目目标
        
        - 提供自然语言到Git操作的转换
        - 支持内网GitLab的代码管理
        - 实现安全的Git操作控制
        - 提供可扩展的CI/CD集成能力
        
        ## 系统架构
        
        ```
        用户指令 → Cursor客户端 → MCP服务端 → GitLab API → 执行Git操作
        ```
        
        ### 核心模块
        
        1. **环境配置模块**
           - 虚拟环境管理
           - 依赖包管理
           - 配置文件管理
        
        2. **GitLab连接模块**
           - GitLab API封装
           - 认证管理
           - 错误处理
        
        3. **MCP服务端**
           - 命令解析
           - 操作执行
           - 结果返回
        
        4. **自然语言处理层**
           - 指令映射
           - 参数解析
           - 默认行为
        
        ### 安全控制
        
        - 访问控制：基于白名单的路径控制
        - 操作审计：完整的操作日志记录
        - 环境隔离：Docker容器化部署
        - 权限管理：基于角色的命令限制
        
        ## 快速开始
        
        ### 安装步骤
        
        1. 在Cursor IDE中打开设置
        2. 找到MCP配置部分
        3. 将以下配置复制到配置文件中：
        ```json
        {
            "name": "gitlab-mcp",
            "version": "0.1.0",
            "description": "GitLab MCP service for Cursor IDE",
            "config": {
                "gitlab_url": "http://your-gitlab-server.com",
                "gitlab_token": "your-access-token"
            }
        }
        ```
        
        4. 修改配置中的`gitlab_url`和`gitlab_token`为你的GitLab信息
        
        ## 支持的命令
        
        ### 基础Git操作
        - `查看状态` - 查看当前仓库状态
        - `更新代码` - 拉取最新代码
        - `提交修改` - 提交代码修改
        - `推送代码` - 推送代码到远程
        - `创建分支` - 创建并切换到新分支
        - `切换分支` - 切换到指定分支
        - `删除分支` - 删除本地分支
        - `删除远程分支` - 删除远程分支
        - `查看日志` - 查看提交历史
        - `查看文件历史` - 查看指定文件的修改历史
        - `查看差异` - 查看工作区和暂存区的差异
        - `暂存修改` - 将修改添加到暂存区
        - `撤销修改` - 撤销工作区的修改
        
        ### GitLab操作
        - `查看项目提交记录` - 查看指定项目的提交记录
        - `列出项目分支` - 查看项目分支
        - `创建合并请求` - 创建合并请求
        - `查看合并请求` - 查看项目的合并请求列表
        - `查看项目成员` - 查看项目成员列表
        - `查看项目标签` - 查看项目标签列表
        - `创建项目标签` - 创建项目标签
        - `查看项目文件` - 查看项目文件列表
        - `查看文件内容` - 查看项目文件内容
        - `搜索项目` - 搜索GitLab项目
        - `查看项目统计` - 查看项目统计信息
        - `查看分支保护` - 查看分支保护设置
        - `设置分支保护` - 设置分支保护规则
        
        ## 获取帮助
        
        如果遇到问题，请检查：
        1. GitLab服务器地址是否正确
        2. 访问令牌是否有足够权限
        
        ## 开发指南
        
        ### 发布新版本
        
        1. 更新版本号
           - 在`setup.py`中更新`version`
           - 在`CHANGELOG.md`中添加新版本说明
        
        2. 构建发布包
        ```bash
        # 安装构建工具（使用国内镜像源）
        pip install -i https://pypi.tuna.tsinghua.edu.cn/simple twine wheel
        
        # 运行发布脚本
        ./release.sh
        ```
        
        3. 发布到PyPI
           - 确保已安装twine
           - 运行发布脚本
           - 输入PyPI账号密码
        
        ### 开发环境设置
        
        1. 克隆项目
        ```bash
        git clone https://github.com/yourusername/gitlab-mcp.git
        cd gitlab-mcp
        ```
        
        2. 创建虚拟环境
        ```bash
        python -m venv venv
        source venv/bin/activate  # Windows: venv\Scripts\activate
        ```
        
        3. 安装开发依赖（使用国内镜像源）
        ```bash
        pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt
        pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -e .
        ```
        
        ## 国内镜像源
        
        如果遇到网络问题，可以使用以下国内镜像源：
        
        1. 清华大学镜像源（推荐）
        ```
        https://pypi.tuna.tsinghua.edu.cn/simple
        ```
        
        2. 阿里云镜像源
        ```
        https://mirrors.aliyun.com/pypi/simple/
        ```
        
        3. 中国科技大学镜像源
        ```
        https://pypi.mirrors.ustc.edu.cn/simple/
        ```
        
        4. 豆瓣镜像源
        ```
        https://pypi.douban.com/simple/
        ```
        
        使用方法：
        ```bash
        # 临时使用
        pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name
        
        # 永久配置
        pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
        ```
        
        ## 许可证
        
        MIT License 
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
