Files
gitea-mcp/BUILDING.md
Lunny Xiao 18fcd663e0 docs: rewrite the tool tables and slim down the READMEs (#215)
Fixes https://gitea.com/gitea/gitea-mcp/issues/214.

The tool tables listed tools that had not existed for several releases. They are regenerated from the registry, gain an `Access` column so it is visible what disappears under `-r` / `GITEA_READONLY`, and get their fine-grained scopes back. `TestReadmeToolTables` now compares them against the registry in both directions, for every translation.

Other corrections from verifying the prose against the source: the pagination parameter is `per_page`, not `perPage`; Go 1.26 is required, not 1.24; the Chinese READMEs were missing the OpenCode and Mistral Vibe sections.

Also trimmed the drifted table of contents and the sections the intro and `gitea-mcp --help` already cover, and dropped the heading emoji. `CLAUDE.md` had its own stale tool list, so it now points at `AGENTS.md` like gitea/gitea does.

---------

Co-authored-by: silverwind <me@silverwind.io>
Reviewed-on: https://gitea.com/gitea/gitea-mcp/pulls/215
Reviewed-by: silverwind <2021+silverwind@noreply.gitea.com>
2026-07-23 17:08:19 +00:00

1.3 KiB

Building gitea-mcp on Windows

This project includes PowerShell and batch scripts to build the gitea-mcp application on Windows systems.

Prerequisites

  • Go 1.26 or later
  • Git (for version information)
  • PowerShell 5.1 or later (included with Windows 10/11)

Build Scripts

PowerShell Script (build.ps1)

The main build script that replicates all Makefile functionality:

# Show help
.\build.ps1 help

# Build the application
.\build.ps1 build

# Install the application
.\build.ps1 install

# Clean build artifacts
.\build.ps1 clean

# Run in development mode (hot reload)
.\build.ps1 dev

# Update vendor dependencies
.\build.ps1 vendor

Batch File Wrapper (build.bat)

A simple wrapper to run the PowerShell script:

# Run with default help target
build.bat

# Run specific target
build.bat build
build.bat install

Available Targets

  • help - Print help message
  • build - Build the application executable
  • install - Build and install to GOPATH/bin
  • uninstall - Remove executable from GOPATH/bin
  • clean - Remove build artifacts
  • air - Install air for hot reload development
  • dev - Run with hot reload development
  • vendor - Tidy and verify Go module dependencies

Output

The build process creates gitea-mcp.exe in the project directory.