Gitea MCP Server

A Model Context Protocol (MCP) server for interacting with Gitea. This package is designed to be used as a standalone server or imported by a gateway.

🛠 Capabilities

• Issues: List, search, create, update, comment.
• Repositories: List repos, branches, labels.
• Files: Read file content.
• Pull Requests: Create PRs.
• Analysis: Analyze issues with AI prompts.
• Shell: Execute safe git commands in WSL (run_safe_shell).

🔒 Security

• Allowed Paths: Restricted via MCP_ALLOWED_PATHS environment variable.
• Git Safety: Only whitelisted git subcommands are allowed. Global flags are blocked.

📦 Installation

npm install @boringstudio_org/gitea-mcp

🚀 Usage

Via NPX (Recommended)

# Configure environment variables
export GITEA_TOKEN=your_token
# Optional: Defaults to https://git.your-instance.com/api/v1
export GITEA_API_URL=https://git.your-instance.com/api/v1

# Cloudflare Access (Optional)
# If your Gitea instance is behind Cloudflare Zero Trust
export CF_ID=your_cf_client_id
export CF_SECRET=your_cf_client_secret

# Run
npx @boringstudio_org/gitea-mcp

Standalone (From Source)

# Install dependencies
npm install

# Configure .env
echo "GITEA_TOKEN=..." > .env
echo "GITEA_API_URL=..." >> .env
# Optional: Cloudflare Access
echo "CF_ID=..." >> .env
echo "CF_SECRET=..." >> .env

# Run
node index.js

As a Library

import { runGiteaServer } from "@boringstudio_org/gitea-mcp";
// Ensure environment variables are set
runGiteaServer().catch(console.error);

🤖 AI & Development Standards

Cursor Rules Integration

This project includes pre-configured Cursor Rules (.cursor/rules/*.mdc) to standardize Gitea-related tool development.

To use them, open this project in Cursor IDE. The rules provide automated guidance for maintaining Boring Studio standards and safe git execution.

📝 License

MIT