@customable/forgejo-mcp (2.0.0)

Published 2025-10-10 10:05:46 +02:00 by jack in customable-mcp/forgejo-mcp

Installation

@customable:registry=
npm install @customable/forgejo-mcp@2.0.0
"@customable/forgejo-mcp": "2.0.0"

About this package

🔧 forgejo-mcp

Version CI Status License NPM

MCP Server for Forgejo API integration - manage repositories, issues, and pull requests.

Features

Repository Operations

  • 📋 list_repos - List all repositories
  • 🔍 get_repo - Get repository details
  • create_repo - Create new repository

Issue Management

  • 📝 list_issues - List issues in a repository
  • create_issue - Create new issue
  • 💬 comment_issue - Add comment to issue
  • 🏷️ add_label - Add label to issue
  • close_issue - Close an issue

Pull Request Operations

  • 🔀 list_prs - List pull requests
  • create_pr - Create pull request
  • 💬 comment_pr - Comment on pull request
  • merge_pr - Merge pull request

User & Organization

  • 👤 get_user - Get user information
  • 🏢 list_org_repos - List organization repositories

Installation

npm install @customable/forgejo-mcp

Or install from Forgejo Package Registry:

# Add to your .npmrc
echo "@customable:registry=https://git.customable.host/api/packages/customable-mcp/npm/" >> .npmrc

# Install
npm install @customable/forgejo-mcp

Configuration

Add to your Claude Code MCP settings (~/.claude/settings.json):

{
  "mcpServers": {
    "forgejo-mcp": {
      "command": "node",
      "args": ["/path/to/node_modules/@customable/forgejo-mcp/dist/index.js"],
      "env": {
        "FORGEJO_URL": "https://git.customable.host",
        "FORGEJO_TOKEN": "your-token-here"
      }
    }
  }
}

Environment Variables

  • FORGEJO_URL - Your Forgejo instance URL (e.g., https://git.customable.host)
  • FORGEJO_TOKEN - Personal Access Token with appropriate permissions

Usage

Once configured, the MCP server will be available in Claude Code. You can use tools like:

list_repos, get_repo, create_repo, list_issues, create_issue, etc.

API Reference

Forgejo API: /api/v1

License

MIT

Dependencies

Dependencies

ID Version
zod ^3.23.8

Development dependencies

ID Version
@modelcontextprotocol/sdk ^1.20.0
@types/node ^22.0.0
@vitest/coverage-v8 ^3.2.4
typescript ^5.5.0
vitest ^3.2.4

Keywords

mcp forgejo git api mcp-server
Details
npm
2025-10-10 10:05:46 +02:00
1
Customable Team
MIT
latest
29 KiB
Assets (1)
Versions (2) View all
2.0.0 2025-10-10
1.0.5 2025-10-07