Forgejo MCP Server

Forgejo MCP Server bridges the gap between a Forgejo instance and Model Context Protocol (MCP) clients such as Claude or Cursor. By exposing a rich set of repository‑centric tools over MCP, it lets conversational AI assistants perform real‑world version control tasks without leaving the chat interface. This eliminates the need for separate CLI or web interactions, enabling developers to manage codebases, issues, and pull requests through natural language commands.

The server implements a comprehensive toolbox that covers every common Git workflow: creating and deleting branches, listing commits, managing files, and handling issues or pull requests. Each tool is scoped to a specific resource type (User, Repository, Branch, File, Issue, Pull Request) and offers straightforward actions like , , or . This fine‑grained API allows an assistant to ask for the latest commit on a branch or to fork a repository with a single sentence, while the server translates those requests into authenticated Forgejo API calls.

For developers, this integration means tighter collaboration between AI assistants and source‑control systems. It supports both stdio and sse transport modes, giving flexibility for different deployment scenarios—from local development to cloud‑hosted services. Debug flags and environment variable support make troubleshooting transparent, while the built‑in version query tool () helps maintain compatibility across updates.

Real‑world use cases include automated code reviews, continuous integration pipelines that trigger on chat commands, and onboarding assistants that walk new contributors through repository setup. Because the server exposes all standard Forgejo operations, it can serve as a central hub for any AI‑driven workflow that needs to read or modify code, issues, or project metadata. Its design prioritizes clarity and safety—each tool requires explicit authentication tokens and respects Forgejo’s permission model, ensuring that conversational commands remain secure.

In summary, the Forgejo MCP Server turns a conventional Git hosting platform into an interactive AI‑powered workspace. By delivering repository operations through MCP, it empowers assistants to become first‑class collaborators in the development lifecycle.