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.
Go¶
Requirements: Go 1.26+ (matching go/go.mod; the go-sdk dependency itself requires 1.25+)
The output binary is kwp-mcp-go (or kwp-mcp-go.exe on Windows if you add .exe).
C# Native AOT¶
Requirements: .NET 10 SDK, platform-appropriate native build tools (e.g. Visual Studio Build Tools on Windows, gcc on Linux)
cd csharp
dotnet publish src/KeywordPlannerMcp/KeywordPlannerMcp.csproj -r <RID> -c Release --self-contained true
Replace <RID> with your target Runtime Identifier:
| Platform | RID |
|---|---|
| Linux x64 | linux-x64 |
| Linux ARM64 | linux-arm64 |
| macOS x64 | osx-x64 |
| macOS ARM64 (Apple Silicon) | osx-arm64 |
| Windows x64 | win-x64 |
The published binary is in csharp/src/KeywordPlannerMcp/bin/Release/net10.0/<RID>/publish/.
Running Tests¶
HTTP Transport¶
No special build steps are needed for HTTP transport support.
cd csharp
dotnet run --project src/KeywordPlannerMcp -- \
--transport http --listen-address 127.0.0.1 --port 8082
Both serve MCP at /mcp and health metadata at /health.