forgejo_admin

Repositories

58

Projects Packages

18

Public activity Starred repositories

ldraney-forgejo-mcp (0.1.0)

Published 2026-03-01 17:44:20 +00:00 by forgejo_admin

Installation

To install the package using pip, run the following command:

pip install --index-url  ldraney-forgejo-mcp

For more information on the PyPI registry, see the documentation.

About this package

MCP server wrapping the Forgejo SDK — SOP-aware workflow tools for agents

forgejo-mcp

MCP server wrapping the Forgejo SDK with SOP-aware workflow tools for AI agents.

This is not a 1:1 API wrapper. Tools encode platform conventions:

• create_issue_and_branch — creates issue + branch named {issue-num}-{slug}
• submit_pr — creates PR from branch, returns link
• review_pr — gets diff + metadata for review
• merge_approved_pr — squash merges after confirmation
• list_issues / list_prs — filtered views

Architecture

forgejo-sdk (httpx wrapper) → forgejo-mcp (SOP workflows)

The SDK does API calls. The MCP layer encodes conventions.

Auth

Set in ~/.mcp.json:

{
  "mcpServers": {
    "forgejo": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/forgejo-mcp", "forgejo-mcp"],
      "env": {
        "FORGEJO_URL": "https://forgejo.example.com",
        "FORGEJO_USER": "...",
        "FORGEJO_PASSWORD": "..."
      }
    }
  }
}

Requirements

Requires Python: >=3.10

Details

PyPI

2026-03-01 17:44:20 +00:00

3

MIT

11 KiB

Assets (2)

ldraney_forgejo_mcp-0.1.0-py3-none-any.whl 6.3 KiB

ldraney_forgejo_mcp-0.1.0.tar.gz 4.8 KiB

Versions (1) View all

0.1.0 2026-03-01