Nyuchi Docs
概要
作者による説明(英語の原文)
Search, read, and ask the Nyuchi docs (docs.nyuchi.com); send feedback or raise issues.
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況iとても新しい↓ 41/週 · ★ –
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: パソコンでもクラウドでも
- トランスポート: stdio, Streamable HTTP
- カテゴリ: 検索・AIの記憶
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック:1項目中1項目に合格
- 作者のサーバーで動きます。あなたが頼んだ内容は、作者のサーバーを通ります。
- レジストリには、入力が必要なキーは載っていません。
必要なもの
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
ウェブ、デスクトップ、モバイルのClaudeで使えます:
- Settings → Connectors を開く
- Add custom connector を押す
- 下のアドレスを貼り付けて Add を押す
- サインインを求められたら、作者のサービスにサインインする
https://docs.nyuchi.com/mcpまたは、パソコンで動かす
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"nyuchi-docs": {
"command": "npx",
"args": [
"-y",
"nyuchi-docs-mcp"
]
}
}
}ターミナルでこれを実行します
claude mcp add --transport http nyuchi-docs https://docs.nyuchi.com/mcpまたは、パソコンで動かす
claude mcp add nyuchi-docs -- npx -y nyuchi-docs-mcpまたは、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"nyuchi-docs": {
"url": "https://docs.nyuchi.com/mcp"
}
}
}または、パソコンで動かす
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"nyuchi-docs": {
"command": "npx",
"args": [
"-y",
"nyuchi-docs-mcp"
]
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"nyuchi-docs": {
"type": "http",
"url": "https://docs.nyuchi.com/mcp"
}
}
}または、パソコンで動かす
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"nyuchi-docs": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"nyuchi-docs-mcp"
]
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
ChatGPTがつなげるのは、インターネット上のサーバーだけです:
- ウェブ版のChatGPTを開き → Settings → Connectors (Apps)
- Create または Add を押す(プランによっては、先に Advanced で Developer mode をオンにする必要があります)
- 下のアドレスを貼り付け、名前を付けて保存する
- サインインを求められたら、作者のサービスにサインインする
https://docs.nyuchi.com/mcpメニューの名前は、プランや時期によって少し違うことがあります。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
できること
このサーバーのツール一覧はまだ読み取っていません。エンドポイントは順番にチェックしています。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月9日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント nyuchi で確認済みです
- … 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
エンドポイントが応答する
まだチェックしていません。エンドポイントは順番にチェックしています
- … 未チェック
OAuthでサインイン
まだチェックしていません。エンドポイントは順番にチェックしています
- … 未チェック
ツールの説明に隠れた指示がない
まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります
検索・AIの記憶のほかのサーバーとの比較i
- このカテゴリのほかの5727件のうち0%よりスターが多い
- このカテゴリのほかの5727件のうち23%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの5727件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Nyuchi Docsは安全ですか?
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は–、最新バージョン(0.1.0)がレジストリに届いたのは4 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ(開発者モードのChatGPTなど)でも使えます。
代わりに使えるものは?
同じカテゴリには:Context7, Codebase Memory, Exa
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
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
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
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.