AegisGitea-MCP/docs/index.md

AegisGitea MCP - Documentation

AegisGitea MCP is a security-first Model Context Protocol (MCP) server that provides controlled AI access to self-hosted Gitea repositories.

Overview

AegisGitea MCP acts as a secure bridge between AI assistants (such as ChatGPT) and your Gitea instance. It exposes a limited set of read-only tools that allow an AI to browse repositories and read file contents, while enforcing strict authentication, rate limiting, and comprehensive audit logging.

Version: 0.1.0 (Alpha)
License: MIT
Requires: Python 3.10+

Documentation

Document	Description
Getting Started	Installation and first-time setup
Configuration	All environment variables and settings
API Reference	HTTP endpoints and MCP tools
Architecture	System design and data flow
Security	Authentication, rate limiting, and audit logging
Deployment	Docker and production deployment

Quick Start

# 1. Clone and install
git clone <repo-url>
cd AegisGitea-MCP
make install-dev

# 2. Configure
cp .env.example .env
# Edit .env with your Gitea URL and token

# 3. Generate an API key
make generate-key

# 4. Run
make run

The server starts at http://localhost:8080.