feat(mcp-docs): scaffold package and docs index engine (ZEL-7841)

[dsklyar]

Summary

• Adds @transcend-io/mcp-server-docs package scaffold with docsIndex.ts (llms.txt parsing, lru-cache-backed getIndex/getBody, SSRF host guard).
• Adds lru-cache to the pnpm catalog and root tsconfig project reference.
• Unit tests cover parsing, index/body caching, and host validation.

Related Issues

• Closes https://linear.app/transcend/issue/ZEL-7841/mcp-scaffold-mcp-server-docs-package-docs-index-engine

Stack

This is PR 1 of 4 for ZEL-7840:

1. This PR — ZEL-7841 scaffold + index engine
2. ZEL-7842 — transcend_docs_list + transcend_docs_fetch tools
3. ZEL-7843 — package glue + cli.ts
4. ZEL-7844 — umbrella wiring + changeset

Test plan

• pnpm run --dir packages/mcp/mcp-server-docs test
• pnpm run --dir packages/mcp/mcp-server-docs build
• pnpm run --dir packages/mcp/mcp-server-docs typecheck
• Pre-commit hooks pass

Demo

Claude using docs list + fetch

Screen.Recording.2026-07-02.at.14.42.09.mov

Cursor demo of caching docs

Screen.Recording.2026-07-02.at.15.12.38.mov

[linear-code]

ZEL-7841

[pkg-pr-new]

Open in StackBlitz

@transcend-io/airgap.js-types

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/airgap.js-types@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/airgap.js-types@256.tgz

@transcend-io/cli

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/cli@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/cli@256.tgz

@transcend-io/internationalization

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/internationalization@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/internationalization@256.tgz

@transcend-io/privacy-types

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/privacy-types@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/privacy-types@256.tgz

@transcend-io/sdk

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/sdk@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/sdk@256.tgz

@transcend-io/type-utils

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/type-utils@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/type-utils@256.tgz

@transcend-io/utils

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/utils@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/utils@256.tgz

@transcend-io/mcp

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp@256.tgz

@transcend-io/mcp-server-admin

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-admin@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-admin@256.tgz

@transcend-io/mcp-server-assessment

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-assessment@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-assessment@256.tgz

@transcend-io/mcp-server-base

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-base@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-base@256.tgz

@transcend-io/mcp-server-consent

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-consent@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-consent@256.tgz

@transcend-io/mcp-server-discovery

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-discovery@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-discovery@256.tgz

@transcend-io/mcp-server-docs

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-docs@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-docs@256.tgz

@transcend-io/mcp-server-dsr

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-dsr@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-dsr@256.tgz

@transcend-io/mcp-server-inventory

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-inventory@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-inventory@256.tgz

@transcend-io/mcp-server-preferences

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-preferences@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-preferences@256.tgz

@transcend-io/mcp-server-workflows

pnpm add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-workflows@256

yarn add https://pkg.pr.new/transcend-io/tools/@transcend-io/mcp-server-workflows@256.tgz

commit: 1f71cd5

[giacaglia]

Pretty cool!