Skip to content

Building from Source

Documentation emits a page-specific WebPage using existing description frontmatter. Its name matches the HTML and social title; its identity matches the slashless, URI-escaped canonical URL. Pages without an authored description are excluded rather than receiving an invented summary. Existing project and instructional schemas remain. The documentation CI job checks built metadata and punctuation/script escaping with python scripts/test-docs-schema.py after the MkDocs build.

Both implementations can be built locally from the repository. Pre-built binaries are available on the Releases page if you don't need to build from source.


Go

Requirements: Go 1.26+

cd go
go mod tidy
go build -ldflags="-s -w" -trimpath -o gsc-mcp-go .

Run tests:

go test ./...

Run linter (requires golangci-lint):

golangci-lint run

C# (.NET 10)

Requirements: .NET 10 SDK

Build for development (no AOT):

cd csharp
dotnet restore SearchConsoleMcp.slnx
dotnet build SearchConsoleMcp.slnx -c Release --no-restore

Run tests:

dotnet test SearchConsoleMcp.slnx -c Release --no-build

Publish as a Native AOT self-contained binary:

dotnet publish src/SearchConsoleMcp/SearchConsoleMcp.csproj \
  -r linux-x64 -c Release --self-contained true
dotnet publish src/SearchConsoleMcp/SearchConsoleMcp.csproj \
  -r osx-arm64 -c Release --self-contained true
dotnet publish src/SearchConsoleMcp/SearchConsoleMcp.csproj ^
  -r win-x64 -c Release --self-contained true

Native AOT requirements

Native AOT compilation on Linux requires clang and zlib1g-dev. Install with:

sudo apt-get install -y clang zlib1g-dev


Running HTTP locally

cd go
go run . --transport http --listen-address 127.0.0.1 --port 8081 \
  --service-account-file /path/to/key.json
cd csharp
dotnet run --project src/SearchConsoleMcp -- \
  --transport http --listen-address 127.0.0.1 --port 8081 \
  --service-account-file /path/to/key.json

Both serve MCP at /mcp and health metadata at /health.


Contributing

  1. Open an issue describing the bug or feature before submitting a PR
  2. Run golangci-lint run (Go) or dotnet build with zero warnings (C#) before submitting
  3. Keep both implementations in sync -- a feature added to Go should also be added to C#