gitea-mcp-server/README.md

Gitea MCP Server

A comprehensive MCP (Model Context Protocol) server for Gitea repository management and automation.

Features

• 50+ Tools: Complete Gitea API coverage - repos, issues, PRs, branches, files, wiki, search, actions, and more
• Multi-Platform: Linux, Windows, macOS (AMD64 & ARM64)
• Multiple Modes: stdio (default) for local MCP clients, HTTP mode for remote servers
• Per-Agent Isolation: Each MCP instance uses a single Gitea token - perfect for multi-agent setups
• Wave 2 Features: Workflow monitoring, action runners, commit status checks, repository structure listing

Quick Start

Installation

# Clone the repository
git clone https://github.com/karti-ai/gitea-mcp-server.git
cd gitea-mcp-server/mcp

# Build
make build

# Or install to $GOPATH/bin
make install

Usage

# stdio mode (default)
gitea-mcp --host https://gitea.example.com --token YOUR_TOKEN

# HTTP mode
gitea-mcp --host https://gitea.example.com --token YOUR_TOKEN --port 8080

Documentation

• Full Documentation - Complete usage guide, all 50+ tools, examples
• Building Guide - Windows build instructions
• Agent Setup - OpenClaw integration with per-agent isolation
• Chinese Docs - 简体中文文档
• Chinese (Traditional) - 繁體中文文件

Project Structure

gitea-mcp-server/
├── mcp/                    # MCP server source code
│   ├── README.md          # Full documentation
│   ├── Makefile           # Build automation
│   ├── Dockerfile         # Container build
│   └── ...
├── AGENTS.md              # OpenClaw setup guide
└── LICENSE                # MIT License

License

MIT License - see LICENSE file for details.

---

Built with ❤️ by Karti AI