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+
Run tests:
Run linter (requires golangci-lint):
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:
Publish as a Native AOT self-contained binary:
Native AOT requirements
Native AOT compilation on Linux requires clang and zlib1g-dev. Install with:
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¶
- Open an issue describing the bug or feature before submitting a PR
- Run
golangci-lint run(Go) ordotnet buildwith zero warnings (C#) before submitting - Keep both implementations in sync -- a feature added to Go should also be added to C#