ronmi/forgejo-mcp

Gitea/Forgejo MCP Server

让AI成为你的代码仓库管理助手

这是一个基于https://modelcontextprotocol.io/%E7%9A%84%E6%9C%8D%E5%8A%A1%E5%99%A8%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8F%AF%E8%AE%A9Claude%E3%80%81Gemini%E3%80%81Copilot%E7%AD%89AI%E5%8A%A9%E6%89%8B%E7%9B%B4%E6%8E%A5%E7%AE%A1%E7%90%86Gitea/Forgejo%E4%BB%A3%E7%A0%81%E4%BB%93%E5%BA%93%EF%BC%8C%E5%AE%9E%E7%8E%B0%E6%99%BA%E8%83%BD%E9%AB%98%E6%95%88%E7%9A%84%E4%BB%93%E5%BA%93%E8%BF%90%E7%BB%B4%E3%80%82

🚀 核心功能

Issue管理

• 创建、编辑、查看issue
• 添加/移除/替换标签
• 管理issue评论与附件
• 设置issue依赖关系

项目组织

• 标签管理（创建、编辑、删除）
• 里程碑管理（创建、编辑、删除）
• 仓库搜索与列表展示

发布管理

• 版本发布管理
• 发布附件管理

其他功能

• 查看Pull Requests
• 管理Wiki页面
• 查看Forgejo/Gitea Actions任务

📦 安装方法

方式1：Docker（推荐）

HTTP模式（远程访问）

bash
docker run -p 8080:8080 -e FORGEJOMCP_TOKEN="你的Forgejo API令牌" docker.xuanyuan.run/ronmi/forgejo-mcp http --address :8080 --server https://git.example.com

Stdio模式（本地集成）

直接在AI客户端配置中使用Docker命令（见下文使用说明）。

方式2：源码安装

bash
go install github.com/raohwork/forgejo-mcp@latest

方式3：预编译二进制

从https://github.com/raohwork/forgejo-mcp/releases%E4%B8%8B%E8%BD%BD%E5%AF%B9%E5%BA%94%E7%B3%BB%E7%BB%9F%E7%89%88%E6%9C%AC%E7%9A%84%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E3%80%82

🖥️ 使用说明

前置步骤：获取Forgejo/Gitea令牌

1. 登录Forgejo/Gitea实例
2. 进入设置→应用→访问令牌
3. 点击生成新令牌
4. 选择权限范围（推荐至少勾选repository和issue的写入权限）
5. 复制生成的令牌

💡 安全提示：建议通过环境变量传递令牌，避免直接写入配置：

bash
export FORGEJOMCP_SERVER="https://你的Forgejo实例地址"
export FORGEJOMCP_TOKEN="你的访问令牌"

Stdio模式（本地客户端集成）

适用于Claude Desktop、Gemini CLI等本地AI助手，通过标准输入输出通信。

AI客户端配置示例（Docker方式）：

json
{
  "mcpServers": {
    "forgejo": {
      "command": "docker",
      "args": [
        "--rm",
        "ronmi/forgejo-mcp",
        "stdio",
        "--server", "https://你的Forgejo实例地址",
        "--token", "你的访问令牌"
      ]
    }
  }
}

HTTP模式（远程访问）

启动Web服务器，支持远程客户端通过HTTP连接，适合多用户场景或Web服务集成。

单用户模式（固定令牌）

bash
docker run -p 8080:8080 -d --rm -e FORGEJOMCP_TOKEN="你的令牌" docker.xuanyuan.run/ronmi/forgejo-mcp http --address :8080 --server https://你的Forgejo实例地址

多用户模式（客户端带令牌）

bash
docker run -p 8080:8080 -d --rm docker.xuanyuan.run/ronmi/forgejo-mcp http --address :8080 --server https://你的Forgejo实例地址

客户端配置示例（多用户模式）：

json
{
  "mcpServers": {
    "forgejo-remote": {
      "type": "sse",
      "url": "http://localhost:8080/sse",
      "headers": {
        "Authorization": "Bearer 你的访问令牌"
      }
    }
  }
}

🛡️ 安全建议

1. 使用环境变量传递服务器地址和令牌，避免明文暴露
2. 最小化令牌权限范围，只授予必要权限
3. 定期轮换访问令牌

📋 使用示例

配置完成后，可通过自然语言让AI助手管理仓库：

• "展示我的Gitea服务器上该仓库的关键bug报告"
• "根据讨论内容创建一个详细的issue，并添加修复方案的评论"
• "生成当前里程碑的进度报告，重点说明近期进展"
• "分析最近的Pull Requests，指出需要优先审查的项"

🤝 支持与贡献

• bug反馈：https://github.com/raohwork/forgejo-mcp/issues
• 代码贡献：欢迎提交Pull Request

📄 许可证

本项目采用Mozilla Public License 2.0许可。

让AI成为你高效的代码仓库管理伙伴！ 🚀