# mcp-gitee-ent

**Repository Path**: chasecyang/mcp-gitee-ent

## Basic Information

- **Project Name**: mcp-gitee-ent
- **Description**: mcp-gitee-ent 是 Gitee Enterprise 的模型上下文协议 (MCP) 服务器实现。它提供了一组与 Gitee Enterprise API 交互的工具，允许 AI 助手管理仓库、Issue、Pull Request等。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 9
- **Created**: 2025-06-12
- **Last Updated**: 2025-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gitee MCP 服务器

Gitee MCP 服务器是一个面向企业级开发的工具集成平台，提供与 Gitee 企业版深度集成的 API 接口服务。支持从 Docker 部署到源码构建的多种部署方式，提供跨平台二进制文件分发。

## 核心功能
- **全栈企业开发支持**  
  覆盖企业级项目管理全流程，包含：
  - 企业组织管理（成员/项目/团队管理）
  - 敏捷开发（需求/迭代/版本管理）
  - 代码协作（PR 创建/评审/合并）
  - 仓库管理（代码树/文件内容/发布管理）

- **开箱即用的 API 集成**
  提供 50+ 标准化 MCP 工具接口，包括：
  ```go
  // 示例：Issue 全生命周期管理
  CreateIssue() // 创建问题
  UpdateIssue() // 更新问题
  ListIssues()  // 查询问题列表
  CommentIssue() // 添加评论
  ```

- **多架构支持**
  提供 Linux/macOS/Windows 系统下的 AMD64/ARM64 架构二进制包
  通过 npm 快速安装：
  ```bash
  npm install -g mcp-gitee-ent
  ```

## 安装指南
### Docker 部署（推荐）
```dockerfile
# 使用官方镜像
docker run -p 8000:8000 gitee/mcp-server:latest
```

### 源码构建
```bash
git clone https://gitee.com/gitee-enterprise/mcp-gitee-ent.git
cd mcp-gitee-ent
make build
./mcp-gitee-ent --version
```

## 快速开始
1. 设置认证信息：
   ```bash
   export GITEE_ACCESS_TOKEN=your_token
   export GITEE_API_BASE=https://api.gitee.com/enterprise
   ```
2. 启动服务：
   ```bash
   ./mcp-gitee-ent --port=8000
   ```
3. 调用示例接口：
   ```curl
   curl -X POST http://localhost:8000/tools \
     -d '{"tool_name":"list_enterprises"}'
   ```

## 开发者文档
- 中文指南：[docs/install/cline.md](docs/install/cline.md)
- 英文指南：[docs/install/claude.md](docs/install/claude.md)
- 集成示例：[docs/images/](docs/images/) 目录下的 PR 评审流程图等可视化文档

## 贡献指南
请参考 [CONTRIBUTING.md](CONTRIBUTING.md)（英文）或 [CONTRIBUTING_CN.md](CONTRIBUTING_CN.md)（中文）了解贡献流程

## 许可证
本项目采用 Apache-2.0 许可证，详情见 [LICENSE](LICENSE) 文件

## 技术支持
- 企业版 API 文档：https://developer.gitee.com/docs/enterprise-api/
- 开发者社区：Gitee 企业版开发者论坛
- 技术咨询：通过 GitHub/Gitee 的 Issues 系统提交请求