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.

Go

Requirements: Go 1.26+ (matching go/go.mod; the go-sdk dependency itself requires 1.25+)

cd go
go build -o kwp-mcp-go .

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

# Go
cd go && go test ./...

# C#
cd csharp && dotnet test

HTTP Transport

No special build steps are needed for HTTP transport support.

cd go
go run . --transport http --listen-address 127.0.0.1 --port 8082
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.