What is Forgejo Mcp

Forgejo MCP is an integration plugin that connects Forgejo with Model Context Protocol (MCP) systems, enabling seamless command execution and repository management via an MCP-compatible chat interface.

Use cases

Use cases for Forgejo MCP include automated repository management, command execution via chatbots, and integration with development tools like VSCode for enhanced productivity.

How to use

To use Forgejo MCP, download the official binary or build from source. Configure the MCP server in your MCP configuration file by specifying the command and arguments, including your Forgejo host and access token. After setup, you can interact with your repositories through an MCP-compatible chat interface.

Key features

Key features of Forgejo MCP include integration with the Forgejo REST API, support for both stdio and SSE modes, and the ability to manage repositories and execute commands through a chat interface.

Where to use

Forgejo MCP can be used in software development environments where Forgejo is utilized for version control and repository management, particularly in teams that prefer chat-based interactions.

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

📥Download the official binary release

You can download the official release from here.

🔧Build from Source

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

git clone https://forgejo.org/forgejo/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

• sse mode

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

[!NOTE]
You can provide your Forgejo host and access token either as command-line arguments or environment variables.
Command-line arguments have the highest priority

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 -t sse [--port 8080] --token <your personal access token> -d

Enjoy exploring and managing your Forgejo repositories via chat!