Forgejo MCP Server logo

Forgejo MCP Server

by goern

The Forgejo MCP Server provides tools and resources for interacting with the Forgejo REST API. It allows users to manage repositories, issues, and user information on Forgejo instances like codeberg.org.

View on GitHub

Last updated: N/A

What is Forgejo MCP Server?

The Forgejo MCP (Model Context Protocol) Server is a tool that acts as an intermediary between a client application (like VSCode or Claude Desktop) and a Forgejo instance. It provides a standardized way to interact with the Forgejo API, simplifying tasks such as listing repositories, managing issues, and retrieving user information.

How to use Forgejo MCP Server?

To use the Forgejo MCP Server, you need to install it either manually or via Smithery. After installation, configure the server with a Codeberg API token. Then, run the server in either Stdio or HTTP mode. Finally, configure your client application to communicate with the MCP server.

Key features of Forgejo MCP Server

  • List and get repositories

  • List, get, and create issues

  • Get user information

  • Dependency injection for modular architecture

  • Robust error handling and request processing

  • Caching layer for improved performance

  • Comprehensive unit and integration tests

  • Enhanced Forgejo issue management commands

Use cases of Forgejo MCP Server

  • Automating Forgejo tasks

  • Integrating Forgejo with other tools

  • Building custom Forgejo clients

  • Simplifying Forgejo API interactions

  • Enhancing issue management workflows

FAQ from Forgejo MCP Server

What is an MCP server?

An MCP (Model Context Protocol) server acts as a bridge between a client application and a service, providing a standardized way to interact with the service's API.

How do I get a Codeberg API token?

You can generate a Codeberg API token in your Codeberg settings under Applications. The token needs appropriate permissions (repo, user).

What is the difference between Stdio and HTTP mode?

Stdio mode is the default mode used by MCP clients like VSCode, communicating via standard input/output. HTTP mode starts a web server that provides information about the MCP server.

How do I configure the API token?

You can configure the API token either using a .env file or by directly editing the MCP settings file for your client application.

What tools are available?

The server provides tools for listing and getting repositories, listing, getting, and creating issues, and getting user information.