# 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

```bash
npm install @boringstudio_org/gitea-mcp
```

## 🚀 Usage

### Via NPX (Recommended)
```bash
# 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)
```bash
# 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
```javascript
import { runGiteaServer } from "@boringstudio_org/gitea-mcp";
// Ensure environment variables are set
runGiteaServer().catch(console.error);
```

## 📝 License

MIT