让 AI 管理你的代码仓库：Gitea MCP Server 接入指南

✅ 本文已于 2026-06-09 在公司内网环境实际验证通过 — 从下载二进制到 MCP 连接绿灯，全程约 15 分钟完成。以下所有步骤均经过实测确认。

背景：为什么要把 Gitea 接入 AI？

前面几篇分别解决了沟通数据（微信/企微）和项目管理（禅道）的 AI 化问题。本篇聚焦代码托管环节——Gitea。

Gitea 是轻量级自托管 Git 平台，在企业内网广泛使用。让 AI 接入 Gitea 后，可以：

• 📦 管理仓库（“帮我创建一个新仓库” / “Fork XX 项目”）
• 🌿 操作分支（“列出所有分支” / “创建 feature 分支”）
• 📝 管理文件（“帮我看看 XX 文件的内容” / “更新配置文件”）
• 🐛 处理 Issue（“查看最近的 Bug Issue” / “创建一个新 Issue”）
• 🔀 处理 PR（“看看有哪些待合并的 PR” / “帮我创建 PR”）
• 🔍 全局搜索（“搜索所有包含 XX 关键词的仓库”）

方案选择：gitea-mcp（Gitea 官方出品）

Gitea 官方维护的 MCP Server，Go 语言编写，预编译单文件部署，下载即用。

为什么选 gitea-mcp？

1. 官方出品 — 由 Gitea 核心维护者开发，API 兼容性有保障
2. 零构建 — 预编译二进制，下载解压即可使用，不需要 Go 环境
3. 功能全面 — 23 个工具覆盖仓库/分支/文件/Issue/PR 全流程
4. 双模式运行 — stdio（简单稳定）和 SSE（支持实时推送）两种模式

技术原理：Gitea REST API + MCP

Gitea REST API

Gitea 兼容 GitHub API（Swagger 文档路径 /api/swagger），提供完整的 RESTful 接口：

GET    /api/v1/repos/{owner}/{repo}           — 获取仓库信息
POST   /api/v1/repos/{owner}/{repo}/issues     — 创建 Issue
GET    /api/v1/repos/{owner}/{repo}/pulls       — 列出 PR
POST   /api/v1/repos/{owner}/{repo}/branches    — 创建分支
PUT    /api/v1/repos/{owner}/{repo}/contents/{path} — 更新文件

认证方式

Gitea 使用 Personal Access Token 认证：

第一步：下载 gitea-mcp

方式一：直接下载预编译版本（推荐）

从官方发布页下载对应平台的二进制文件：

https://gitea.com/gitea/gitea-mcp/releases

选择 Windows x86_64 版本，下载后解压到指定目录：

1
2

# 建议存放路径
D:\Software\AI\gitea-mcp\gitea-mcp.exe

💡 这是最简单的方式——不需要 Go 环境，不需要编译，下载即用。文件仅 ~4.1 MB。

方式二：源码编译

如果需要自定义修改或预编译版本不适用：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

cd D:\Software\AI

# 克隆仓库
git clone https://gitea.com/gitea/gitea-mcp.git
cd gitea-mcp

# 设置 Go 代理（国内加速）
set GOPROXY=https://goproxy.cn,direct

# 编译
go build -o gitea-mcp.exe .

# 编译完成后复制到目标目录
copy gitea-mcp.exe D:\Software\AI\gitea-mcp\

第二步：获取 Gitea Access Token

在 Gitea 网页端生成 Personal Access Token：

1. 登录 Gitea
2. 进入 Settings → Applications → Manage Access Tokens
3. 点击 Generate New Token
4. 填写 Token 名称（如 AI-Assistant）
5. 勾选权限范围：
   • repo — 仓库读写权限
   • read:user — 读取用户信息
   • write:issue — Issue 写入权限（按需）
   • write:pull_request — PR 写入权限（按需）
6. 点击 Generate Token
7. 立即复制 Token（只显示一次！）

⚠️ 安全提示：Access Token 等于你的 Gitea 账号权限，切勿泄露。建议初期只勾选读权限，确认稳定后再逐步开放写权限。

第三步：配置 WorkBuddy MCP 连接

在 WorkBuddy 的 MCP 配置文件中添加 Gitea 服务器。

配置文件位置

C:\Users\<你的用户名>\.workbuddy\mcp.json

⚠️ 注意：配置文件路径是 ~/.workbuddy/mcp.json，不是 ~/.workbuddy/.mcp.json（没有前导点号）。如果文件不存在，直接创建即可。

stdio 模式配置（推荐）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
  "mcpServers": {
    "gitea": {
      "command": "D:\\Software\\AI\\gitea-mcp\\gitea-mcp.exe",
      "args": [
        "-t", "stdio",
        "--host", "https://你的Gitea地址",
        "--token", "你的Access-Token"
      ]
    }
  }
}

SSE 模式配置（备选）

适合需要实时事件推送的场景：

步骤 1 — 启动服务器：

1

D:\Software\AI\gitea-mcp\gitea-mcp.exe -t sse --host https://你的Gitea地址 --token 你的Access-Token

步骤 2 — 客户端配置：

1
2
3
4
5
6
7

{
  "mcpServers": {
    "gitea": {
      "url": "http://localhost:8080/sse"
    }
  }
}

命令行参数说明

第四步：信任 MCP 服务器

配置完成后，需要手动信任：

1. 打开 WorkBuddy 客户端
2. 进入连接器管理页面
3. 在顶部自定义连接器入口找到 gitea
4. 点击信任按钮激活
5. 重启 WorkBuddy 会话使 MCP 生效

23 个工具详解

用户管理（2 个）

仓库管理（3 个）

分支管理（3 个）

Commit 管理（1 个）

文件操作（4 个）

Issue 管理（4 个）

PR 管理（3 个）

搜索与组织（3 个）

完整架构图

┌─────────────────────────────────────────────────┐
│                  AI 助手                         │
│              (WorkBuddy / 其他)                  │
└──────────────┬──────────────────────────────────┘
               │  MCP 协议 (stdio / SSE)
               ▼
┌─────────────────────────────────────────────────┐
│     gitea-mcp.exe (Go 单文件, ~4.1 MB)          │
│  ┌───────────────────────────────────────────┐  │
│  │  23 tools                                 │  │
│  │  仓库 / 分支 / 文件 / Issue / PR / 搜索   │  │
│  └───────────────────────────────────────────┘  │
│  --host + --token (启动参数)                     │
└──────────────┬──────────────────────────────────┘
               │  Gitea REST API (HTTP)
               │  Personal Access Token 认证
               ▼
┌─────────────────────────────────────────────────┐
│              Gitea 代码托管平台                    │
│         (https://你的Gitea地址)                   │
│  ┌────────────┬────────────┬────────────┐       │
│  │ Repos      │ Issues     │ PRs        │       │
│  ├────────────┼────────────┼────────────┤       │
│  │ Branches   │ Files      │ Commits    │       │
│  └────────────┴────────────┴────────────┘       │
└─────────────────────────────────────────────────┘

Gitea vs Gerrit：两个代码平台 MCP 对比

Gitea 和 Gerrit 虽然都涉及代码管理，但定位完全不同，两者互补：

典型配合场景：

开发者推送代码 → Gitea 仓库收到 Push
                  ↓
              Gitea 触发 PR
                  ↓
          Gerrit 发起 Code Review
                  ↓
       AI 助手同时操作两边：
       - Gitea: 创建 Issue 记录 Bug
       - Gerrit: 查看变更 diff，发布审查意见

六系统接入全景对比

核心发现：在所有接入方案中，Gitea 的部署难度最低——官方提供预编译二进制，下载解压即可使用，不需要任何编译或构建步骤。如果团队已经在使用 Gitea，这是最先推荐的 AI 接入方案。

踩坑实录（已验证）

💡 实测结论：stdio 模式 + HTTP 协议 + Access Token，全流程零踩坑。官方预编译二进制开箱即用，无需任何编译或构建步骤。

注意事项与风险提示

⚠️ 使用前请充分了解以下风险：

1. 代码安全 — Gitea 中的代码属于企业核心资产，AI 读取文件内容时可能接触敏感逻辑和密钥
2. 操作权限 — create_file、update_file、delete_file 等写操作需要谨慎授权
3. Token 安全 — Access Token 等于你的完整 Gitea 权限，泄露风险极大
4. 审计合规 — 通过 AI 执行的操作应可追溯
5. 内网访问 — 公司 Gitea 通常在内网，需要确保 AI 运行环境可访问
6. 文件误操作 — AI 执行 delete_file 或 update_file 前应确认文件内容

建议：

• 初期建议只勾选读权限（read:repository, read:user），确认稳定后再开放写权限
• Token 名称标注用途（如 AI-Assistant-ReadOnly），便于管理和审计
• 定期轮换 Token，不要长期使用同一个
• 发布博客时，不要暴露真实的 Gitea 地址和 Token

当前状态

实际验证记录（2026-06-09）

环境信息

验证步骤

1. API 连通性测试 — 使用 curl 直接调用 Gitea REST API：

   1	curl -H "Authorization: token <your-token>" http://<gitea-host>/api/v1/user

   返回 HTTP 200，包含用户信息（login, email, full_name 等）。

2. 仓库列表测试 — 调用 /api/v1/repos/search 接口：

   1	curl -H "Authorization: token <your-token>" http://<gitea-host>/api/v1/repos/search?limit=5

   成功返回仓库列表，包含 AI_Project、jx_devel 等组织下的仓库。

3. MCP 工具调用测试 — 在 WorkBuddy 会话中直接使用自然语言：

   • “我有哪些仓库？” → list_my_repos 返回 30 个仓库
   • “我的 Gitea 账号信息” → get_me 返回认证用户详情
   • “查看 XT_Android 最近的提交” → list_commits 返回完整的 commit 历史

实际使用的 MCP 配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
  "mcpServers": {
    "gitea": {
      "command": "D:\\Work\\AI\\Workspace\\Connection\\gitea-mcp\\gitea-mcp.exe",
      "args": [
        "-t", "stdio",
        "--host", "http://<内网Gitea地址>",
        "--token", "<your-access-token>"
      ]
    }
  }
}

⚠️ 上述配置中的地址和 Token 已脱敏，请替换为你自己的实际值。

系列文章（AI 工具链）

本博客「AI 工具链」系列，教你把各类研发工具接入 AI 助手（悟空）：

• 让 AI 管理你的代码仓库：Gitea MCP Server 接入指南
• 让 AI 帮你管代码评审：Gerrit 接入指南
• 让 AI 管理你的项目：禅道接入指南
• 让 AI 读懂你的微信聊天记录：wechat-cli + wx_key 接入指南
• 让 AI 读懂你的企业微信：wechat-decrypt 接入指南
• 在 WorkBuddy 中通过 REST API 操作 Jenkins：原理与实战
• 在 Jenkins 上搭建基于 Docker 的编译流水线：手把手教程