mushroomfleet/gitea-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

17 stars 9 forks 品質 72 トレンド 21Apache-2.0

Repository Install

MCP サーバは、AI のコーディングアシスタントから、リポジトリ、問題、プルリクエスト、組織を管理します

概要

セルフホストのGetaプラットフォームとのシームレスな統合を実現する、Model Context Protocol(MCP)サーバーです。ディレクトリ構造を保存しながら、リポジトリやファイルをアップロードするためのツールを提供しています。このガイドは、一般的な問題のトラブルシューティングを含む、Geta MCP サーバーのインストールと設定に関するステップバイステップの手順を提供します。 - : 設定されたGetaインスタンスで新しいリポジトリを作成します。 - : ディレクトリ構造を保存しながらファイルとフォルダをアップロード - : 初期コミット(新しいファイルのみ)のためのプロジェクト全体を自動同期 - : 既存のファイルを変更するためのコンフリクトの解像度を持つスマートアップデートツール - : 複数のGetaインスタンスに同時に接続 - : API レートの制限をインスタンスごとに尊重する - : 効率的なファイルアップロードと構成可能なバッチサイズ - : 安全出力で構造化されたロギング - : 再試行ロジックでエラー処理を強要する - : フルタイプの安全性と現代のJavaScript機能 - Node.js 18.0.

概要（AI 翻訳）

セルフホストのGetaプラットフォームとのシームレスな統合を実現する、Model Context Protocol(MCP)サーバーです。ディレクトリ構造を保存しながら、リポジトリやファイルをアップロードするためのツールを提供しています。

インストールとセットアップガイド

このガイドは、一般的な問題のトラブルシューティングを含む、Geta MCP サーバーのインストールと設定に関するステップバイステップの手順を提供します。

##特徴

リポジトリ作成: 設定済みのGetaインスタンスに新しいリポジトリを作成します。 -File Upload: ディレクトリ構造を保存しながらファイルとフォルダをアップロードする -Project Sync:初期コミットのプロジェクト全体を自動同期(新しいファイルのみ)
高度なファイル更新: 既存のファイルを修正するためのコンフリクト解像度を備えたスマートアップデートツール -マルチインスタンスサポート:複数のGetaインスタンスを同時に接続 -Rate Limiting: インスタンスごとに API レート制限を尊重する
バッチ処理:構成可能なバッチサイズの効率的なファイルアップロード
包括的なロギング:セキュリティに安全な出力で構造化されたロギング -エラー処理: 再試行ロジックでエラー処理を強化
TypeScript:フルタイプの安全性とモダンなJavaScript機能

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

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

Clone the repository:

git clone 
cd gitea-mcp

Install dependencies:

npm install

Configure environment variables:

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

Build the project:

npm run build

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

GitHub で README 全文を見る

インストール

docker run -d \

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "gitea-mcp": {
      "command": "node",
      "args": ["./build/index.js"],
      "cwd": "/path/to/gitea-mcp",
      "env": {
        "NODE_ENV": "production",
        "LOG_LEVEL": "info"
      }
    }
  }
}