Gitea MCP Tool

# Gitea API 覆盖度分析 ## 执行摘要 **已实现**: 95 个 MCP 工具 (对应 92 个 API 函数) **分析日期**: 2025-11-23 **Gitea API 版本**: v1.22+ --- ## 已实现功能模块 ### ✅ 完全实现 (100% 覆盖) | 模块 | 工具数 | 覆盖度 | 说明 | |------|--------|--------|------| | **Issue** | 8 | 100% | 创建、更新、列表、评论、关闭 | | **Pull Request** | 10 | 100% | 创建、更新、列表、合并、审查 | | **Milestone** | 5 | 100% | 完整的 CRUD 操作 | | **Label** | 14 | 100% | 仓库/组织标签 + Issue 标签操作 | | **Project** | 8 | 100% | 看板管理 + 列管理 | | **Wiki** | 8 | 100% | 完整的 Wiki 管理 + 版本历史 | | **Release** | 9 | 100% | 版本发布 + 附件管理 | | **Webhook** | 11 | 100% | 仓库/组织 Webhook | | **Team** | 11 | 100% | 团队管理 + 成员 + 仓库 | | **Token** | 3 | 100% | API Token 管理 | ### ⚠️ 部分实现 (50-99% 覆盖) | 模块 | 工具数 | 覆盖度 | 已实现 | 缺失 | |------|--------|--------|--------|------| | **Repository** | 11 | ~60% | 基本 CRUD, 搜索 | 分支、Tag、文件内容、协作者、部署密钥 | | **Organization** | 2 | ~40% | 基本信息、成员列表 | 创建、更新、删除、权限管理 | | **User** | 3 | ~50% | 当前用户、获取用户、组织列表 | SSH Key、GPG Key、关注、星标 | ### ❌ 未实现 (0% 覆盖) | 模块 | 说明 | 重要度 | |------|------|--------| | **Notification** | 通知管理 | ⭐⭐⭐⭐ 高 | | **Commit** | 提交历史、比较 | ⭐⭐⭐⭐ 高 | | **Branch** | 分支管理 | ⭐⭐⭐⭐⭐ 很高 | | **Tag** | Git 标签管理 | ⭐⭐⭐⭐ 高 | | **Contents** | 文件读写 | ⭐⭐⭐⭐⭐ 很高 | | **Status** | 提交状态 (CI/CD) | ⭐⭐⭐ 中 | | **Collaborator** | 协作者管理 | ⭐⭐⭐⭐ 高 | | **Deploy Keys** | 部署密钥 | ⭐⭐⭐ 中 | | **SSH Keys** | SSH 密钥管理 | ⭐⭐⭐ 中 | | **GPG Keys** | GPG 密钥管理 | ⭐⭐ 低 | | **Topics** | 仓库主题 | ⭐⭐ 低 | | **Starred** | 星标仓库 | ⭐⭐ 低 | | **Following** | 关注用户 | ⭐⭐ 低 | | **Admin** | 管理员操作 | ⭐⭐⭐ 中 | | **Settings** | 全局设置 | ⭐⭐ 低 | | **Package** | 包管理 | ⭐⭐⭐ 中 | | **Actions** | CI/CD Actions | ⭐⭐⭐⭐ 高 | --- ## 详细缺失 API 分析 ### 1. Branch 管理 (⭐⭐⭐⭐⭐ 很高优先级) **缺失的 API**: ``` GET /repos/:owner/:repo/branches # 列出分支 GET /repos/:owner/:repo/branches/:branch # 获取分支详情 POST /repos/:owner/:repo/branches # 创建分支 DELETE /repos/:owner/:repo/branches/:branch # 删除分支 GET /repos/:owner/:repo/branches/:branch/protection # 获取分支保护 PUT /repos/:owner/:repo/branches/:branch/protection # 设置分支保护 DELETE /repos/:owner/:repo/branches/:branch/protection # 删除分支保护 ``` **使用场景**: - Git Flow 工作流自动化 - 分支管理和清理 - 保护主分支（防止强制推送） - CI/CD 分支策略 **预计工具数**: 7 个 --- ### 2. Contents (文件内容) (⭐⭐⭐⭐⭐ 很高优先级) **缺失的 API**: ``` GET /repos/:owner/:repo/contents/:filepath # 获取文件内容 PUT /repos/:owner/:repo/contents/:filepath # 创建/更新文件 DELETE /repos/:owner/:repo/contents/:filepath # 删除文件 GET /repos/:owner/:repo/raw/:filepath # 获取原始文件 GET /repos/:owner/:repo/archive/:archive # 下载归档 ``` **使用场景**: - 读写配置文件 - 自动化代码生成 - 文档更新 - 批量文件操作 **预计工具数**: 5 个 --- ### 3. Commit 管理 (⭐⭐⭐⭐ 高优先级) **缺失的 API**: ``` GET /repos/:owner/:repo/commits # 列出提交 GET /repos/:owner/:repo/commits/:sha # 获取提交详情 GET /repos/:owner/:repo/commits/:sha/statuses # 获取提交状态 POST /repos/:owner/:repo/statuses/:sha # 创建提交状态 GET /repos/:owner/:repo/compare/:base...:head # 比较提交 ``` **使用场景**: - 提交历史分析 - 代码变更追踪 - CI/CD 状态报告 - 代码审查准备 **预计工具数**: 5 个 --- ### 4. Tag 管理 (⭐⭐⭐⭐ 高优先级) **缺失的 API**: ``` GET /repos/:owner/:repo/tags # 列出 Tag GET /repos/:owner/:repo/tags/:tag # 获取 Tag 详情 POST /repos/:owner/:repo/tags # 创建 Tag DELETE /repos/:owner/:repo/tags/:tag # 删除 Tag ``` **使用场景**: - 版本标记 - Release 准备 - 历史版本管理 **预计工具数**: 4 个 **注意**: 我们在 Repository 模块中已经部分实现，需要确认。 --- ### 5. Notification (通知) (⭐⭐⭐⭐ 高优先级) **缺失的 API**: ``` GET /notifications # 列出通知 GET /notifications/threads/:id # 获取通知详情 PATCH /notifications/threads/:id # 标记已读 PUT /notifications # 全部标记已读 GET /repos/:owner/:repo/notifications # 仓库通知 ``` **使用场景**: - 通知管理 - Issue/PR 更新提醒 - 自动化响应 **预计工具数**: 5 个 --- ### 6. Collaborator (协作者) (⭐⭐⭐⭐ 高优先级) **缺失的 API**: ``` GET /repos/:owner/:repo/collaborators # 列出协作者 GET /repos/:owner/:repo/collaborators/:username # 检查协作者 PUT /repos/:owner/:repo/collaborators/:username # 添加协作者 DELETE /repos/:owner/:repo/collaborators/:username # 移除协作者 ``` **使用场景**: - 权限管理 - 团队成员管理 - 自动化邀请 **预计工具数**: 4 个 --- ### 7. SSH Keys (⭐⭐⭐ 中优先级) **缺失的 API**: ``` GET /user/keys # 列出 SSH Key GET /user/keys/:id # 获取 SSH Key POST /user/keys # 添加 SSH Key DELETE /user/keys/:id # 删除 SSH Key ``` **使用场景**: - 密钥管理 - 自动化部署设置 **预计工具数**: 4 个 --- ### 8. Deploy Keys (⭐⭐⭐ 中优先级) **缺失的 API**: ``` GET /repos/:owner/:repo/keys # 列出部署密钥 GET /repos/:owner/:repo/keys/:id # 获取部署密钥 POST /repos/:owner/:repo/keys # 添加部署密钥 DELETE /repos/:owner/:repo/keys/:id # 删除部署密钥 ``` **使用场景**: - CI/CD 密钥管理 - 自动化部署 **预计工具数**: 4 个 --- ### 9. Organization 完善 (⭐⭐⭐ 中优先级) **缺失的 API**: ``` POST /orgs # 创建组织 PATCH /orgs/:org # 更新组织 DELETE /orgs/:org # 删除组织 GET /orgs/:org/repos # 列出组织仓库 ``` **使用场景**: - 组织生命周期管理 - 批量仓库管理 **预计工具数**: 4 个 --- ### 10. Actions (CI/CD) (⭐⭐⭐⭐ 高优先级) **缺失的 API**: ``` GET /repos/:owner/:repo/actions/workflows # 列出工作流 GET /repos/:owner/:repo/actions/runs # 列出运行记录 GET /repos/:owner/:repo/actions/runs/:run_id # 获取运行详情 POST /repos/:owner/:repo/actions/runs/:run_id/rerun # 重新运行 DELETE /repos/:owner/:repo/actions/runs/:run_id # 删除运行记录 ``` **使用场景**: - CI/CD 管理 - 工作流自动化 - 构建历史查询 **预计工具数**: 5+ 个 --- ### 11. Package (包管理) (⭐⭐⭐ 中优先级) **缺失的 API**: ``` GET /packages/:owner # 列出包 GET /packages/:owner/:type/:name/:version # 获取包详情 DELETE /packages/:owner/:type/:name/:version # 删除包 ``` **使用场景**: - 包仓库管理 - 依赖管理 **预计工具数**: 3 个 --- ### 12. 其他功能 #### Topics (仓库主题) - `GET /repos/:owner/:repo/topics` - `PUT /repos/:owner/:repo/topics` - 预计: 2 个工具 #### Starred (星标) - `GET /user/starred` - `GET /users/:username/starred` - `PUT /user/starred/:owner/:repo` - `DELETE /user/starred/:owner/:repo` - 预计: 4 个工具 #### Following (关注) - `GET /user/following` - `GET /users/:username/following` - `PUT /user/following/:username` - `DELETE /user/following/:username` - 预计: 4 个工具 #### Admin (管理员) - 用户管理 - 组织管理 - 仓库管理 - 系统设置 - 预计: 10+ 个工具 --- ## 优先级推荐 ### 第一批（核心功能补充） 预计新增: **35-40 个工具** 1. ⭐⭐⭐⭐⭐ **Branch 管理** (7 个) 2. ⭐⭐⭐⭐⭐ **Contents 文件操作** (5 个) 3. ⭐⭐⭐⭐ **Commit 管理** (5 个) 4. ⭐⭐⭐⭐ **Tag 管理** (4 个) 5. ⭐⭐⭐⭐ **Notification 通知** (5 个) 6. ⭐⭐⭐⭐ **Collaborator 协作者** (4 个) 7. ⭐⭐⭐⭐ **Actions CI/CD** (5+ 个) **理由**: 这些是日常开发最常用的功能，对 DevOps 工作流至关重要。 --- ### 第二批（权限和密钥管理） 预计新增: **12-15 个工具** 1. ⭐⭐⭐ **SSH Keys** (4 个) 2. ⭐⭐⭐ **Deploy Keys** (4 个) 3. ⭐⭐⭐ **Organization 完善** (4 个) **理由**: 安全和权限管理，适合企业用户。 --- ### 第三批（增强功能） 预计新增: **13-15 个工具** 1. ⭐⭐⭐ **Package 包管理** (3 个) 2. ⭐⭐ **Topics 主题** (2 个) 3. ⭐⭐ **Starred 星标** (4 个) 4. ⭐⭐ **Following 关注** (4 个) **理由**: 社交功能和包管理，提升用户体验。 --- ### 第四批（管理员功能） 预计新增: **10+ 个工具** 1. ⭐⭐⭐ **Admin 管理员** (10+ 个) 2. ⭐⭐ **GPG Keys** (4 个) 3. ⭐⭐ **Settings 设置** (若干) **理由**: 针对系统管理员，使用频率较低但很重要。 --- ## 总结 ### 当前状态 - ✅ 已实现: **95 个工具** - ✅ 覆盖度: **约 60%** (估算) ### 完整覆盖预估 - 🎯 第一批完成后: **130-135 个工具** (约 85% 覆盖) - 🎯 第二批完成后: **142-150 个工具** (约 92% 覆盖) - 🎯 第三批完成后: **155-165 个工具** (约 95% 覆盖) - 🎯 第四批完成后: **165-180 个工具** (约 98% 覆盖) ### 核心缺失模块 | 优先级 | 模块 | 工具数 | 说明 | |--------|------|--------|------| | 🔴 很高 | Branch | 7 | Git 分支管理 | | 🔴 很高 | Contents | 5 | 文件读写操作 | | 🟠 高 | Commit | 5 | 提交历史 | | 🟠 高 | Tag | 4 | Git 标签 | | 🟠 高 | Notification | 5 | 通知管理 | | 🟠 高 | Collaborator | 4 | 协作者管理 | | 🟠 高 | Actions | 5+ | CI/CD | --- ## 建议行动计划 ### 短期 (1-2 周) 实现第一批核心功能，重点是 **Branch** 和 **Contents**，这两个模块对 Git 工作流最重要。 ### 中期 (1 个月) 完成第一批所有功能，达到 **130+ 工具**，覆盖度提升到 **85%**。 ### 长期 (2-3 个月) 逐步完成第二、三、四批，达到 **98% 覆盖度**，成为最完整的 Gitea MCP 实现。 --- ## 参考资源 ### Sources: - [Gitea API Swagger UI](https://demo.gitea.com/api/swagger) - 完整的 API 列表 - [Gitea API Documentation](https://docs.gitea.com/api/1.20/) - 官方文档 - [Gitea API Usage Guide](https://docs.gitea.com/next/development/api-usage) - 使用指南 --- **生成时间**: 2025-11-23 **基于版本**: Gitea v1.22+ **当前实现**: 95 个工具