Forgejo MCP

🚀 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"
    }
  }
}

⚠️ 重要提示 你可以通過命令行參數或環境變量提供你的 Forgejo 主機和訪問令牌，且命令行參數具有最高優先級。

配置完成後，嘗試在 MCP 兼容的聊天框中輸入以下內容：

列出我所有的倉庫

✅ 可用工具

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

🚈 調試

要啟用調試模式，請在運行 forgejo-mcp 時添加 -d 或 --debug 標誌：

forgejo-mcp -d

這將使服務器輸出詳細的調試信息，幫助你排查問題。