用途
forgejo-mcp 是一个 Model Context Protocol（MCP）服务器，可将 AI 助手（如 Claude、Gemini、Copilot）与 Gitea/Forgejo 代码仓库连接起来，让 AI 帮助你管理仓库。
主要能力
议题管理
- 创建、编辑和查看议题
- 添加、移除和替换标签
- 管理议题评论和附件
- 设置议题依赖关系
项目组织
- 管理标签（创建、编辑、删除）
- 管理里程碑（创建、编辑、删除）
- 仓库搜索和列表
版本与发布管理
- 管理版本发布
- 管理发布附件
其他
- 查看 Pull Requests
- 管理 Wiki 页面
- 查看 Forgejo/Gitea Actions 任务
使用方式
支持三种安装方式：
- 使用 Docker（推荐）。STDIO 模式可跳过此步直接配置；SSE/Streamable HTTP 模式需先运行 forgejo-mcp 作为服务器，再配置 MCP 客户端。
- 从源码安装。
- 下载预编译二进制文件（从 Releases 页面下载对应操作系统版本）。
工具提供两种主要运行模式：stdio（用于本地集成）和 http（用于远程访问）。
配置 MCP 客户端前，需在 Forgejo/Gitea 服务器创建访问令牌：登录实例 → Settings → Applications → Access Tokens → Generate New Token → 选择权限范围（建议至少包含 repository 和 issue 写权限）→ 复制令牌。
Stdio 模式（本地客户端）
适合与 Claude Desktop、Gemini CLI 等本地 AI 助手客户端集成，通过标准输入/输出直接通信。
HTTP 服务器模式（远程访问）
启动 Web 服务器，允许远程客户端通过 HTTP 连接。
- 单用户模式：启动时提供 --token（或环境变量 FORGEJOMCP_TOKEN），所有操作使用该令牌。命令示例：forgejo-mcp http --address :8080 --server https://git.example.com --token your_token
- 多用户模式：不提供令牌时，服务器要求客户端每次请求发送 Authorization: Bearer <token> 头。
远程 MCP 客户端可配置连接多用户模式服务器；若连接单用户模式服务器，可省略 headers 字段。
安全建议
- 使用环境变量：设置 FORGEJOMCP_SERVER 和 FORGEJOMCP_TOKEN，然后从配置中移除 --server 和 --token。
- 限制令牌权限：仅授予必要的权限范围。
- 定期轮换令牌：定期更新访问令牌。
适用场景
- 智能进度跟踪：让 AI 帮助跟踪项目进度并分析瓶颈。
- 自动化议题分类：根据内容自动标记议题标签和设置里程碑。
- 优先级排序：让 AI 分析议题内容以帮助确定任务优先级。
- 代码审查辅助：在 Pull Requests 中获取 AI 建议和见解。
- 项目文档整理：自动整理 Wiki 文档和发布说明。
限制与支持
项目采用 Mozilla Public License 2.0 许可。Bug 报告可通过 GitHub Issues 提交，欢迎通过 Pull Requests 贡献代码。具体使用的令牌权限细节、环境变量完整列表、各安装方式详细步骤等，官方文档未在本资料中完整提供。
