Nyuchi Docs
Überblick
Beschreibung vom Entwickler (englisches Original)
Search, read, and ask the Nyuchi docs (docs.nyuchi.com); send feedback or raise issues.
Die drei Säulen von PopNx MCP
Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.
- Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
- Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
- NutzungiGanz neu↓ 41/Wo. · ★ –
Was du damit machen kannst
Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.
- Verbindung: Computer oder Cloud
- Transport: stdio, Streamable HTTP
- Kategorie: Suche & KI-Gedächtnis
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Bevor du installierst
- Basischecks: 1 von 1 bestanden
- Läuft auf dem Server des Entwicklers: Was du fragst, läuft über dessen Server.
- Die Registry nennt keinen Schlüssel zum Eintragen.
Du brauchst
- Läuft in der CloudNichts zu installieren; die Verbindung läuft übers Internet
- npmNode.js installiert (für den Befehl npx)
Welche App nutzt du?
Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.
Funktioniert in Claude im Web, auf dem Desktop und auf dem Handy:
- Öffne Settings → Connectors
- Tippe auf Add custom connector
- Füge die Adresse unten ein und tippe auf Add
- Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an
https://docs.nyuchi.com/mcpOder führ ihn auf deinem Computer aus
Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein
{
"mcpServers": {
"nyuchi-docs": {
"command": "npx",
"args": [
"-y",
"nyuchi-docs-mcp"
]
}
}
}Führe das in deinem Terminal aus
claude mcp add --transport http nyuchi-docs https://docs.nyuchi.com/mcpOder führ ihn auf deinem Computer aus
claude mcp add nyuchi-docs -- npx -y nyuchi-docs-mcpOder kopier die Einstellungen selbst
In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen
{
"mcpServers": {
"nyuchi-docs": {
"url": "https://docs.nyuchi.com/mcp"
}
}
}Oder führ ihn auf deinem Computer aus
Oder kopier die Einstellungen selbst
In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen
{
"mcpServers": {
"nyuchi-docs": {
"command": "npx",
"args": [
"-y",
"nyuchi-docs-mcp"
]
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Oder kopier die Einstellungen selbst
In .vscode/mcp.json in deinem Projekt einfügen
{
"servers": {
"nyuchi-docs": {
"type": "http",
"url": "https://docs.nyuchi.com/mcp"
}
}
}Oder führ ihn auf deinem Computer aus
Oder kopier die Einstellungen selbst
In .vscode/mcp.json in deinem Projekt einfügen
{
"servers": {
"nyuchi-docs": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"nyuchi-docs-mcp"
]
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
ChatGPT verbindet sich nur mit Servern im Internet:
- Öffne ChatGPT im Web → Settings → Connectors (Apps)
- Tippe auf Create oder Add (bei manchen Tarifen musst du zuerst Developer mode unter Advanced einschalten)
- Füge die Adresse unten ein, gib ihr einen Namen und speichere
- Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an
https://docs.nyuchi.com/mcpMenünamen können sich je nach Tarif und mit der Zeit leicht unterscheiden.
Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Was er kann
Die Tool-Liste dieses Servers haben wir noch nicht gelesen; wir prüfen die Endpunkte reihum.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 8. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto nyuchi bestätigt, dem das Repo gehört
- … Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
- … Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
- … Noch nicht geprüft
Endpunkt antwortet
Noch nicht geprüft; wir prüfen die Endpunkte reihum
- … Noch nicht geprüft
Anmeldung mit OAuth
Noch nicht geprüft; wir prüfen die Endpunkte reihum
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen
Im Vergleich mit anderen in Suche & KI-Gedächtnisi
- Mehr Sterne als 0 % der anderen 5688 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 23 % der anderen 5688 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 100 % der anderen 5688 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist Nyuchi Docs sicher?
Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.
Läuft er auf meinem Computer oder in der Cloud?
Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.1.0) kam vor 4 Monaten in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL, also funktionieren auch Apps, die Remote-MCP-Server akzeptieren, zum Beispiel ChatGPT im Entwicklermodus.
Was kann ich stattdessen nutzen?
In derselben Kategorie: Context7, Codebase Memory, Exa
Alternativen
Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Codebase Memory
Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.
Exa
Connect AI agents to Exa for web search, content fetching, and multi-step research.
README vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
Nyuchi Docs
Nyuchi engineering documentation — how things are done at Nyuchi, and how
to use the Mzizi tools from a Nyuchi project.
Live: docs.nyuchi.com | Product docs: docs.bundu.org | MCP: docs.nyuchi.com/mcp
Packages
A pnpm workspace of six packages.
| Package | Path | What it does |
|---|---|---|
site | site/ | The Astro + Starlight docs site itself. Ships as a Cloudflare Worker with Static Assets. |
@nyuchi/nyuchi-docs-search | nyuchi-docs-search/ | cmdk-style search modal + Ask-AI tab for Starlight sites. Not yet published to npm. |
shamwari-docs-ai | shamwari-docs-ai/ | Cloudflare Worker — the Ask-AI chat proxy (SSE). |
nyuchi-docs-mcp-worker | nyuchi-docs-mcp-worker/ | Cloudflare Worker nyuchi-docs-mcp — the docs MCP server at docs.nyuchi.com/mcp. |
@nyuchi/nyuchi-docs-mcp | nyuchi-docs-mcp/ | The stdio bridge to that hosted endpoint, for clients that cannot speak Streamable HTTP. |
@nyuchi/nyuchi-docs-skills | nyuchi-docs-skills/ | The public agent skill for docs.nyuchi.com. The repo's authoring skills are internal and deliberately not shipped. |
Companion site
bundu-labs/bundu-docs covers the Bundu Foundation's outward-facing projects — the Mzizi product, the Ubuntu doctrine, and the Bundu brand system. It is an internal-visibility repository, so that link resolves only for org members. It consumes @nyuchi/nyuchi-docs-search and points at the nyuchi-docs-mcp worker.
@nyuchi/nyuchi-docs-searchis not on npm —registry.npmjs.org
returns
{"error":"Not found"}for it (checked 2026-09-12). Until it is
published,
bundu-docscannot install it from the registry.
Sections (site/src/content/docs/)
- `platform/` — the product guide for the Nyuchi platform.
- `api/` — API Docs: the
/v1gateway, WorkOS authentication, console-managed API keys, security, and the product namespaces. - `analytics/` — dashboards, reports, and connecting data sources.
- `kweli/` — Mukoko Kweli product guides: verification, cross-app how-to, open data, data quality, design system.
- `mukoko-weather/` — Mukoko Weather user guide and stations.
- `integrations/` — connectors, webhooks, the docs MCP server, and the Mukoko Events MCP server.
- `identity/` — WorkOS,
accounts.mukoko.com(the AuthKit issuer), SSO, JWTs. - `console/` — the Nyuchi Console at
platform.nyuchi.com. - `tools/` — the cross-repo tools directory: every skill, CLI, and MCP server across the Nyuchi and Bundu repos.
- `mzizi-tools/` —
mzizi-mcp,mzizi-cli,mzizi-skills, the DNA double-helix architecture, registry health, and the A2A design. - `deployment/` — Cloudflare, Vercel, and Supabase deployment patterns.
- `conventions/` — PR doctrine, commit doctrine, repo-naming rules.
Develop
pnpm install
pnpm dev # site only pnpm -r build # all packages pnpm -r test # all packages
Site dev server: http://localhost:4321. Content lives in site/src/content/docs/; the sidebar is configured in site/astro.config.mjs.
Search + Ask AI
The search modal opens with ⌘K / Ctrl+K. The Ask AI tab streams answers from shamwari-docs-ai (Cloudflare Worker) with retrieval-grounded citations. To enable it locally, copy site/.env.example to site/.env:
cp site/.env.example site/.env
.env:
PUBLIC_SHAMWARI_AI_URL=https://shamwari-docs-ai.nyuchi.workers.dev
Deploy
Both workers in this repo deploy via Cloudflare Workers Builds — the Cloudflare GitHub App is connected to nyuchi/nyuchi-docs with one trigger per worker (root directory points at the worker package). No GitHub Actions deploy workflow, no CLOUDFLARE_API_TOKEN repo secret.
- `nyuchi-docs` (site) — root
site/, ships as a Cloudflare Worker with Workers Static Assets. Live athttps://nyuchi-docs.nyuchi.workers.dev, and the cutover is done:docs.nyuchi.comnow serves this Worker. Both hosts return the same Astro 7.2.9 / Starlight 0.41.10 page (checked 2026-09-12); there is no Mintlify-on-Vercel deployment behind the apex any more. - `shamwari-docs-ai` — root
shamwari-docs-ai/, thin proxy in front of Cloudflare AI Search. Live athttps://shamwari-docs-ai.nyuchi.workers.dev, which serves exactly two routes:GET /healthandPOST /chat. Its root returns404, correctly. Seeshamwari-docs-ai/README.mdfor the per-corpus AI Search instance setup (managed via REST API). - `nyuchi-docs-mcp` — root
nyuchi-docs-mcp-worker/, the docs MCP server. Live athttps://nyuchi-docs-mcp.nyuchi.workers.devand routed fromdocs.nyuchi.com/mcp*. Needs its own Workers Builds trigger (root directorynyuchi-docs-mcp-worker/).
Well-known and machine-readable endpoints
docs.nyuchi.com serves these outside the docs tree. Most are static files in site/public/; security.txt is generated per request by the site worker.
| Path | Served from | What it is |
|---|---|---|
/robots.txt | site/public/robots.txt | Crawl policy + sitemap pointer. Everything here is meant to be indexed. |
/llms.txt | site/public/llms.txt | Machine-readable site index for LLMs. |
/AUTH.md | site/public/AUTH.md | Agent-facing WorkOS auth reference, synced from nyuchi/api-gateway. |
/.well-known/mcp/server-card.json | site/public/.well-known/mcp/ | MCP server card for the nyuchi-docs-mcp worker at /mcp. |
/.well-known/security.txt | site/src/worker/security-txt.ts | RFC 9116 disclosure contact — generated per request, not a static file. |
security.txt is dynamic because RFC 9116 makes Expires mandatory and caps it under one year, so a checked-in file silently becomes non-compliant as it ages. site/wrangler.toml sets run_worker_first = true, so every request already passes through site/src/worker/gate.ts; it answers this path before the gate check and before the asset router, deriving Expires from the request time (180 days out). Same approach as mukoko-dev/mukoko-events (formerly nhimbe) and mukoko-dev/kweli.
Why pnpm workspace
The search package (nyuchi-docs-search) is consumed by both nyuchi-docs (this repo, via workspace:*) and bundu-docs (separate repo, via the npm registry). Keeping it in the same workspace as the docs site means local changes to the search UI are picked up instantly during pnpm dev, while the published package is a single pnpm publish away.
Commands
| Command | Description |
|---|---|
pnpm dev | The docs site on :4321 |
pnpm build | Build the site |
pnpm build:all | Build every workspace package |
pnpm test | Every package's tests |
pnpm lint | Every package's linter |
pnpm check | Every package's type/content check |
pnpm skills:validate | Validate the shipped agent skills |
pnpm deploy:worker | Deploy shamwari-docs-ai |
pnpm deploy:mcp | Deploy nyuchi-docs-mcp-worker |
pnpm ingest | Re-ingest the corpus into Cloudflare AI Search |
Never run
prettier --writeon an.mdxfile. Prettier 3.9.x rewrites
{/* … */}to{/_ … _/}and produces invalid MDX..mdis safe.
Ecosystem
- docs.bundu.org — Bundu Foundation product docs
- mzizi.dev — the Mzizi design system, an open-architecture project of the Bundu Foundation, operated and developed by Nyuchi
- api.nyuchi.com — the
/v1gateway these docs describe
Versioning
Releases follow the org versioning policy (nyuchi/.github#80). The branch decides the bump, and there are no version labels:
- A merge into `staging` (the live beta) is tagged as the next patch automatically, by
staging-version.yml. - A release to `main` is the next minor above the highest tag. The PR that releases sets
versioninnyuchi-docs-mcp/package.jsonto it. CI refuses any other version and names the right one. - A major is only ever made by hand: the owner runs the release workflow from the Actions tab with
bump: major. - Each segment holds 0–999. Patch 999 rolls into the next minor; minor 999 stops and asks for a manual major.
Versions released before 2026-10-04 are not renumbered.
Licence
This repository is public but carries no LICENSE file, so no licence is granted over it as a whole: all rights reserved. © Nyuchi Africa (PVT) Ltd. The @nyuchi/nyuchi-docs-search package declares MIT in its own package.json; if that is the intent for the package, the repository needs a LICENSE to back it.