Сервер Model Context Protocol (MCP) для бесшовной интеграции с платформами Gitea. Этот сервер предоставляет инструменты для создания репозиториев и загрузки файлов при сохранении структуры каталогов.

Руководство по установке и установке

Это руководство содержит пошаговые инструкции по установке и настройке сервера Gitea MCP, включая устранение неполадок.

Особенности

Создание репозиториев: создание новых репозиториев на любом настроенном экземпляре Gitea ** Загрузка файлов**: загрузка файлов и папок при сохранении структуры каталогов Проектная синхронизация: автоматическая синхронизация всех проектов для начальных сборов (только новые файлы) ** Расширенные обновления файлов**: Умный инструмент обновления с разрешением конфликтов для изменения существующих файлов ** Поддержка нескольких организаций**: подключение к нескольким экземплярам Gitea одновременно ** Ограничение ставок**: Уважайте ограничения скорости API Batch Processing: эффективная загрузка файлов с настраиваемыми размерами пакетов Комплексная вырубка: структурированная вырубка с безопасным выходом ** Обработка ошибок** Надежная обработка ошибок с помощью логики retry TypeScript: полная безопасность типов и современные функции JavaScript

Gitea MCP Server

A production-ready Model Context Protocol (MCP) server for seamless integration with self-hosted Gitea platforms. This server provides tools for creating repositories and uploading files while preserving directory structure.

Installation and Setup Guide

This guide provides step-by-step instructions for installing and configuring the Gitea MCP server, including troubleshooting common issues.

Features

• Repository Creation: Create new repositories on any configured Gitea instance
• File Upload: Upload files and folders while preserving directory structure
• Project Sync: Automatically sync entire projects for initial commits (new files only)
• Advanced File Updates: Smart update tool with conflict resolution for modifying existing files
• Multi-Instance Support: Connect to multiple Gitea instances simultaneously
• Rate Limiting: Respect API rate limits per instance
• Batch Processing: Efficient file upload with configurable batch sizes
• Comprehensive Logging: Structured logging with security-safe output
• Error Handling: Robust error handling with retry logic
• TypeScript: Full type safety and modern JavaScript features

Quick Start

Prerequisites

• Node.js 18.0.0 or higher
• Access to one or more Gitea instances
• Personal access tokens for authentication

Installation

1. Clone the repository:

git clone 
cd gitea-mcp

2. Install dependencies:

npm install

3. Configure environment variables:

cp .env.example .env
# Edit .env with your Gitea instance details

4. Build the project:

npm run build

5. Start the server:

npm run start:mcp

Troubleshooting Common Issues

Windows Compatibility

If you’re running on Windows, you might encounter issues with the build script. The default build script uses the chmod command, which is not available on Windows. The package.json has been updated to use a Windows-compatible build script.

Logging Configuration

If you encounter issues with the logging configuration, make sure you have the pino-pretty package installed:

npm install --save-dev pino-pretty

Environment Variables

The .env file should contain the following configuration:

# Server Configuration
NODE_ENV=development
LOG_LEVEL=debug

# Gitea Configuration
# Replace with your Gitea instance URL and token
GITEA_INSTANCES=[{"id":"main","name":"Main Gitea Instance","baseUrl":"https://your-gitea-instance.com","token":"your-personal-access-token","timeout":30000,"rateLimit":{"requests":100,"windowMs":60000}}]

# Upload Configuration
MAX_FILE_SIZE=10485760
MAX_FILES=100
BATCH_SIZE=10

# Gitea API Configuration
GITEA_TIMEOUT=30000
GITEA_MAX_RETRIES=3