Forgejo MCP Server

Forgejo MCP Server is an integration plugin designed to connect Forgejo with Model Context Protocol (MCP) systems. This allows for seamless command execution and repository management through an MCP-compatible chat interface.

🚧Installation

🔧Build from Source

You can download the source code by cloning the repository using Git:

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

Before building, make sure you have the following installed:

• make
• Golang (Go 1.24 or later recommended)

Then run:

make build

📁Add to PATH

After building, copy the binary forgejo-mcp to a directory included in your system's PATH. For example:

cp forgejo-mcp /usr/local/bin/

🚀Usage

This example is for Cursor, you can also use plugins in VSCode.

To configure the MCP server for Forgejo, add the following to your MCP configuration file:

• stdio mode

{
  "mcpServers": {
    "forgejo": {
      "command": "forgejo-mcp",
      "args": [
        "--transport", "stdio",
        "--url", "https://forgejo.example.org"
        // "--token", ""
      ],
      "env": {
        // "FORGEJO_URL": "https://forgejo.example.org",
        "FORGEJO_ACCESS_TOKEN": ""
      }
    }
  }
}

• sse mode

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

[!NOTE]

You can provide your Forgejo URL and access token either as command-line arguments or environment variables.

Command-line arguments have the highest priority. Environment variables have been updated:

- Use FORGEJO_URL instead of the deprecated GITEA_HOST

- Use FORGEJO_ACCESS_TOKEN instead of the deprecated GITEA_ACCESS_TOKEN

- Use FORGEJO_DEBUG instead of the deprecated GITEA_DEBUG

The old GITEA_* variables are still supported for backward compatibility but will show deprecation warnings.

Once everything is set up, try typing the following in your MCP-compatible chatbox:

list all my repositories

✅Available Tools

The Forgejo MCP Server supports the following tools:

🐛Debugging

To enable debug mode, add the -d flag when running the Forgejo MCP Server with sse mode:

./forgejo-mcp --transport sse --url  [--sse-port 8080] --token  --debug

Enjoy exploring and managing your Forgejo repositories via chat!