Forgejo MCP 服务器

Forgejo MCP 服务器 是一个集成插件，用于将 Forgejo 连接至模型上下文协议（MCP）系统。这使得通过兼容 MCP 的聊天界面执行命令和管理仓库成为可能。

🚧 安装

📥 下载官方二进制文件

你可以从 这里 下载官方二进制文件。

🔧 从源码构建

你可以通过 Git 克隆仓库来下载源代码：

git clone https://forgejo.org/forgejo/forgejo-mcp.git

在构建之前，请确保安装了以下工具：

• make
• Golang（推荐使用 Go 1.24 或更高版本）

然后运行：

make build

📁 添加到 PATH

构建完成后，将二进制文件 forgejo-mcp 复制到系统 PATH 包含的目录中。例如：

cp forgejo-mcp /usr/local/bin/

🚀 使用方法

此示例适用于 Cursor，你也可以在 VSCode 中使用插件。 要配置 Forgejo 的 MCP 服务器，请将以下内容添加到你的 MCP 配置文件中：

• stdio 模式

{
  "mcpServers": {
    "forgejo": {
      "command": "forgejo-mcp",
      "args": [
        "-t", "stdio",
        "--host", "https://forgejo.org"
        // "--token", "<你的个人访问令牌>"
      ],
      "env": {
        // "GITEA_HOST": "https://forgejo.org",
        "GITEA_ACCESS_TOKEN": "<你的个人访问令牌>"
      }
    }
  }
}

• sse 模式

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

[!NOTE] 你可以通过命令行参数或环境变量提供你的 Forgejo 主机和访问令牌。 命令行参数具有最高优先级

配置完成后，尝试在 MCP 兼容的聊天框中输入以下内容：

列出我所有的仓库

✅ 可用工具

Forgejo MCP 服务器支持以下工具：

🚈 调试

要启用调试模式，请在运行 forgejo-mcp 时添加 -d 或 --debug 标志：

forgejo-mcp -d

这将使服务器输出详细的调试信息，帮助你排查问题。