gitea-mcp/README.md

Gitea MCP Server

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

🚧 Installation

There is currently no official release. You will need to build the Gitea MCP Server from source.

🔧 Build from Source

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

git clone https://gitea.com/gitea/gitea-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 gitea-mcp to a directory included in your system's PATH. For example:

cp gitea-mcp /usr/local/bin/

🚀 Usage

This example is for Cursor, you can also use plugins in VSCode. To configure the MCP server for Gitea, add the following to your MCP configuration file:

• stdio mode

{
  "mcpServers": {
    "gitea": {
      "command": "gitea-mcp",
      "args": [
        "-t", "stdio",
        "--host", "https://gitea.com"
        // "--token", "<your personal access token>"
      ],
      "env": {
        // "GITEA_HOST": "https://gitea.com",
        "GITEA_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

• sse mode

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

Note

You can provide your Gitea 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

Enjoy exploring and managing your Gitea repositories via chat!