Skip to content

feat: docs MCP server at docs.nyuchi.com/mcp + Kweli competitive audit#13

Merged
bryanfawcett merged 2 commits into
mainfrom
claude/claude-md-docs-n16yru
Jul 16, 2026
Merged

feat: docs MCP server at docs.nyuchi.com/mcp + Kweli competitive audit#13
bryanfawcett merged 2 commits into
mainfrom
claude/claude-md-docs-n16yru

Conversation

@bryanfawcett

Copy link
Copy Markdown
Contributor

What

1. The docs site is now an MCP server — docs.nyuchi.com/mcp (read + write).

  • shamwari-docs-ai gains a POST /mcp endpoint (MCP Streamable HTTP transport, JSON-RPC 2.0, stateless) in src/mcp.ts:
    • Read tools: search_docs and ask_docs ride the existing NYUCHI_DOCS AI Search binding (same corpus as the Ask-AI tab); read_page fetches and text-extracts any docs.nyuchi.com page (host-locked).
    • Write tools: submit_feedback (correction/confusing/missing/praise) and raise_issue persist to the new shamwari-docs-feedback KV namespace (FEEDBACK binding, id 9c5af0b2… already created); when the optional GITHUB_TOKEN worker secret is set, raise_issue files real GitHub issues on this repo labeled docs-feedback/via-mcp, with KV as the no-token/failure fallback.
  • wrangler.toml adds a path route docs.nyuchi.com/mcp* (takes precedence over the static site worker's custom domain for that path only) + the KV binding.
  • Discovery: server card at site/public/.well-known/mcp/server-card.json, an Agents section in llms.txt, and a new guide page integrations/docs-mcp (in the sidebar).
  • Tests: 8 new Vitest cases for the MCP endpoint (initialize, tools/list, tool calls, KV writes, 405/-32601) — 17/17 green across the worker.

2. Kweli competitive audit — new kweli/competitive-audit page: full-site audit of kweli.mukoko.com vs Trustpilot, Google Business Profile, Yelp, Foursquare, TripAdvisor, legacy African directories and Jiji. Four lenses (doing well / missing / bugs / steal), a condensed scoreboard matrix, the Africa whitespace nobody serves, and a P0–P2 priority order.

3. Meta docs kept in the loopCLAUDE.md and README.md updated for the new worker surface and pages.

Verification

  • pnpm -r build — site builds (52 pages incl. the 2 new ones), worker tsc --noEmit clean
  • pnpm -r test — search package + worker: all green (worker now 17 tests)

Post-merge ops (one-time, manual)

  • Cloudflare Workers Builds will deploy the worker; the docs.nyuchi.com/mcp* route activates with it.
  • Optional: wrangler secret put GITHUB_TOKEN (issues:write on this repo) to turn raise_issue into real GitHub issues.

🤖 Generated with Claude Code

https://claude.ai/code/session_01AWBw8x1b3AoxNsccoEUs43


Generated by Claude Code

- shamwari-docs-ai gains POST /mcp (Streamable HTTP, JSON-RPC): read
  tools search_docs/ask_docs/read_page over the existing AI Search
  binding; write tools submit_feedback/raise_issue into the new
  FEEDBACK KV namespace (optional GITHUB_TOKEN secret files real
  GitHub issues). Routed from docs.nyuchi.com/mcp* via wrangler
  routes; 8 new Vitest cases (17 total green).
- Server card at /.well-known/mcp/server-card.json, agents section in
  llms.txt, integrations/docs-mcp guide page.
- kweli/competitive-audit: full-site audit vs Trustpilot/GBP/Yelp/
  Foursquare/TripAdvisor/African directories — doing well / missing /
  bugs / steal, scoreboard matrix, Africa whitespace, P0-P2 priorities.
- CLAUDE.md + README updated for the new surface.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 15, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
shamwari-docs-ai 2174b29 Commit Preview URL

Branch Preview URL
Jul 15 2026, 09:45 PM

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 15, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
nyuchi-docs 2174b29 Commit Preview URL

Branch Preview URL
Jul 15 2026, 09:46 PM

Makes the docs MCP server installable everywhere:

- nyuchi-docs-mcp/ — dependency-free stdio bridge to the hosted
  Streamable HTTP endpoint (npx nyuchi-docs-mcp; endpoint overridable
  via arg or NYUCHI_DOCS_MCP_URL). 5 Vitest cases; vitest pinned to
  the workspace's ^2 line to avoid hoist collisions with the search
  package's jest-dom setup.
- server.json — official MCP registry manifest
  (io.github.nyuchi/nyuchi-docs) advertising both the remote
  streamable-http endpoint and the npm stdio package.
- .github/workflows/publish-mcp.yml — on GitHub release: version
  lockstep check (package.json vs server.json), test, npm publish
  (NPM_TOKEN secret), then mcp-publisher publish via GitHub OIDC.
- Docs updated: integrations/docs-mcp install/release sections,
  CLAUDE.md package inventory, npm README.
@bryanfawcett
bryanfawcett marked this pull request as ready for review July 16, 2026 04:52

@claude claude Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Code review skipped — your organization's overage spend limit has been reached.

Code review is billed via overage credits. To resume reviews, an organization admin can raise the monthly limit at claude.ai/admin-settings/claude-code.

Once credits are available, push a new commit or reopen this pull request to trigger a review.

@bryanfawcett
bryanfawcett merged commit d37dca1 into main Jul 16, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants