Repository navigation
feat: expose knowledge-base documentation through an MCP server - #119
Open
oto-macenauer-absa wants to merge 6 commits into
Open
oto-macenauer-absa wants to merge 6 commits into
oto-macenauer-absa wants to merge 6 commits into
Conversation
- http: log only a validated JSON-RPC method and never throw from the access log; main.js catches handler rejections so one request cannot exit Node (and with it the container) - http: rate-limit per client (X-Forwarded-For, KB_MCP_TRUSTED_PROXIES hops from the right) with a global backstop, instead of one shared bucket any caller could drain - http/nginx: answer MCP CORS preflight in Node for allowed origins; nginx's static OPTIONS shortcut now skips /knowledge-base/mcp - build: write dist/_error/not-found.html, which nginx's error_page serves, and guard it in the Dockerfile; every 404 was a 500 - corpus: fall back to slug/empty description for iframe entries without name or description, as the rest of the build does - extract: recurse into div/section/figure/blockquote, join inline runs before trimming, and keep code blocks' whitespace verbatim - search: bound fuzzy matching by term length with early exit, and skip it for the compact whole-query token - server: compute the resources/read continuation offset from the real header length Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Expose generated documentation through a public, read-only MCP endpoint so compatible AI agents can discover, search, and read Knowledge Base content without authentication.
Changes
POST /knowledge-base/mcpthrough nginx; supervise loopback Node MCP process with nginx.Release notes
Knowledge Base deployments now expose an unauthenticated, read-only MCP endpoint at
/knowledge-base/mcp. Deployment owners must allow unauthenticated POST forwarding for this path and setKB_MCP_PUBLIC_ORIGINwhen agents need absolute document links.Verification
node scripts/setup-test-apps.mjs && npm run build:headless— greennpm test— 237 passednpx playwright test --config=playwright.config.ci.js— 23 passednpx playwright test tests/mcp-server.spec.js— 6 passednpm run test:container— 37 passednpm audit --omit=dev --audit-level=high— greenContract impact
contract/DEPLOYMENT.mdchanges deployment runtime and gateway requirements; artifact contract schemas remain unchanged.Closes #117