Commit Graph

15 Commits

Author SHA1 Message Date
Bobo 5710d284d1 docs: use canonical templates URL (#2279)
Co-authored-by: Bo Zhang <187063395+Tethys0@users.noreply.github.com>
2026-08-17 12:57:32 -07:00
Andrew Khadder c83d1d9737 Merge remote-tracking branch 'origin/main' into canary
# Conflicts:
#	libraries/typescript/packages/server/specs/CLI_SPEC.md
#	libraries/typescript/packages/server/specs/SPEC.md
#	libraries/typescript/packages/server/specs/VIEWS_SPEC.md
2026-08-07 22:28:12 -07:00
Andrew Khadder e41076fb3f feat: improve Skills over MCP Inspector support (#2196)
* Codex worktree snapshot: archive-cleanup

Co-authored-by: Codex

* feat: improve skills over MCP inspector support

* fix: address Skills review feedback
2026-08-07 21:55:54 -07:00
claude[bot] b06cc3fe1b docs(examples): add runnable TypeScript examples to the root examples folder (#2194)
* docs(examples): add runnable TypeScript examples to root examples folder

Copy four curated server examples (basic, excalidraw, property-search,
schema-validators) from libraries/typescript/packages/server/examples/
into examples/typescript/ as standalone packages: mcp-use pinned to the
published ^2.0.4 instead of workspace:*, workspace-only verify scripts
and property-search's pnpm-lock.yaml dropped. Update the folder README
to list them alongside the existing per-package example links.

* docs(examples): move run commands into per-example READMEs

Per review on #2194: the top-level examples/typescript README is now a
plain index; install/run commands live in each example's own README
(standalone npm, not pnpm workspace). Adds a README for
schema-validators covering its three sub-packages.

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-08-07 14:36:49 -07:00
Ayaan Gazali 92928c1339 docs: drop examples README entries whose examples no longer exist (#2158)
Finishes what #2132 started. Those 17 links had an exact v2 home; these 9
do not, because the examples themselves were not carried into v2. The
entries advertise examples that are not in the tree, so removing them is
more accurate than leaving a link that cannot resolve.

examples/README.md now has zero broken relative links.
2026-08-05 16:05:45 -07:00
Ayaan Gazali f3e81dbd87 docs: repoint examples README at the v2 example directories (#2132)
The v2 merge deleted libraries/typescript/packages/mcp-use, so 26 of the
86 relative links in examples/README.md are dead. This fixes the 17 that
have an exact home in the v2 tree: client examples moved to
packages/client/examples, and the server ones lost the features/ grouping
and renamed oauth/ to auth/.

The remaining 9 point at examples with no v2 counterpart at all, so
fixing them means dropping the entry or aiming it somewhere approximate.
Left untouched pending a call on those.
2026-08-04 11:05:57 -07:00
Enrico e5cfc5e40b fix(agent): slim deps, relocate examples, and fix install docs
Drop chalk/cli-highlight from @mcp-use/agent (inline ANSI for prettyStreamEvents), remove the redundant ./browser entry, default autoInitialize in simplified mode, and ship package examples plus corrected install guidance (client is a transitive dep; /langchain is a subpath).
2026-07-24 13:37:16 -07:00
Andrew Khadder cbef1f8a36 fix stale v2 view examples (#1935) 2026-07-18 17:45:02 -07:00
Andrew Khadder eabae55ea4 feat(server): add Better Auth OAuth provider (#1921) 2026-07-17 17:31:19 -07:00
Luigi Pederzani 6b2db4a2b0 docs: reorganize docs and examples around MCP Servers + MCP Apps (#1363)
Reshape docs, examples, and indexes to mirror the README narrative:
MCP Servers + MCP Apps are primary; MCP Agent and MCP Client are
present but secondary. Remove duplicated concepts, deprecated pages,
and stale examples; add redirects for removed paths.

Docs
- Rewrite home/index.mdx: tagline + MCP Server / MCP App split cards,
  quickstart tabs, MCP Apps widget snippet, Templates teaser, Inspector,
  Deploy, Agent+Client in a collapsed accordion.
- New home/templates.mdx gallery (Chart Builder, Diagram Builder, Slide
  Deck, Maps Explorer, Widget Gallery, and more) with demo URLs and
  deploy buttons, mirroring the README.
- Simplify python/typescript welcome.mdx: drop duplicated "What is MCP?"
  / "Why mcp-use?" (single pointer to home/mcp101); server-first Next
  Steps; fix broken Python links.
- docs.json: Home product reshaped (Welcome, MCP Apps, Templates, Dev
  Tools + CLI reference, Concepts, Libraries, Misc). Python
  Integrations collapsed into MCP Agents → LLM Adapters.
  fastapi_mount added to Python MCP Server Overview. TS MCP Apps adds
  creating-mcp-apps-server; OAuth Providers gets keycloak + custom.
  Empty API Reference, misrouted Community, and Blog tabs removed from
  TS SDK.
- Delete: ui-widgets.mdx, mcp-ui-resources.mdx,
  comparison-with-other-implementations.mdx, api-reference.mdx (empty),
  typescript/development/security.mdx, python/blog/middleware.mdx,
  python/server/auth/index.mdx.
- Redirects: old paths → current equivalents.
- CLI reference: new "What's New" card group (HMR, --tunnel, skills
  add, generate-types); cross-link from `start` to Tunneling guide.

Examples
- Rewrite libraries/typescript/.../examples/server/ui/mcp-ui/ as a
  programmatic MCP Apps widget gallery (welcome-card, quick-poll,
  task-card) using server.uiResource({ type: "mcpApps", htmlTemplate }).
  Removes deprecated UIResource / rawHtml / remoteDom patterns.
- Delete empty server/ui/apps-sdk/.
- Fix stale docs URL in server/ui/mcp-apps/apps-sdk/index.ts.
- Update examples/README.md and TS examples README: add Templates
  pointer (github.com/mcp-use/mcp-use#templates + docs/home/templates),
  list previously-missing examples (mcp-apps, files, model-context,
  middleware, session-management, better-auth, Python orphans), flag
  apps-sdk as legacy.
2026-05-03 22:57:45 +02:00
Pietro Zullo b2d9425446 fix: replace examples symlinks with navigable READMEs (#1160)
* fix: replace examples symlinks with redirect READMEs

GitHub's web UI renders symlinks as plain text showing the target path
instead of navigating to the linked directory. Replace the symlinks
with directories containing README files that link to the actual
example directories, so clicking through works on GitHub.

Closes MCP-865

* fix: add example READMEs with descriptions to library directories

Add README.md files to the actual example directories so GitHub
renders them when browsing. Each README lists all examples with
short descriptions in table format.

- libraries/python/examples/README.md
- libraries/typescript/packages/mcp-use/examples/README.md
- Update redirect READMEs in examples/python and examples/typescript

Closes MCP-865
2026-03-06 11:17:59 +01:00
Enrico Toniato 2fe66c1749 Update TypeScript examples in README to reflect new file structure and clarify client usage 2026-02-24 18:46:36 -08:00
Enrico Toniato 9f387c1eb2 fix: update documentation links and examples for clarity
- Updated Discord link in SKILL.md to the new invite URL.
- Corrected the path for the Apps SDK example in examples/README.md.
- Enhanced deployment instructions in cli/README.md for better clarity on environment variables.
- Added a reference link for Dynamic Client Registration in workos/README.md.
2026-02-15 11:30:33 -08:00
Enrico Toniato 1d5e3c9924 fix(inspector): resolve OAuth flow looping issue and enhance connection handling (#784)
- Removed duplicate fallback logic in the useAutoConnect hook to fix the OAuth flow looping issue.
- Streamlined connection management and improved user experience through better state handling.
- Enhanced auto-connect functionality and proxy handling for more reliable authentication processes.
- Updated theme toggling with a dropdown menu for improved accessibility and user interaction.
2026-01-11 12:27:38 +01:00
Luigi Pederzani 310efdf4bf add examples symlinks 2025-10-15 18:20:50 +02:00