skills/mcp-use__mcp-use
1
0
Fork 0
mirror of https://github.com/mcp-use/mcp-use.git synced 2026-09-14 18:06:01 +08:00
Code Issues Packages Projects Releases Wiki Activity
1,620 Commits 360 Branches 1,651 Tags
codex/a2ui-example
Commit Graph

5 Commits

Author SHA1 Message Date
Andrew Khadder 01208e052a Revert "docs: split TypeScript V1 and V2 documentation (#2010)" (#2036) 
This reverts commit 5b5fe96d28.
 2026-07-28 10:23:24 -07:00
Andrew Khadder 5b5fe96d28 docs: split TypeScript V1 and V2 documentation (#2010) 
Preserve the V1 TypeScript docs, add independently navigable V2 beta documentation, and align shared documentation. Rename both V2 migration guides to “Migrating to v2”.
 2026-07-28 10:16:33 -07:00
Andrew Khadder 68afda5885 docs(typescript): review and rewrite TypeScript docs (MCP-2466) (#1780) 
* docs: remove stale feedback block and orphaned anchor from docs.json

* chore(docs): make Typescript more prominent

* chore(docs): Update `welcome.mdx`

* docs: rewrite TypeScript quickstart and welcome pages

Refocus the quickstart on create-mcp-use-app (scaffold, run, and deploy a
first MCP server) and drop the agent/client/server primer table and
diagram. Convert the welcome page's server + widget example from Tabs to
CodeGroup and tighten the intro wording.

* docs: remove stale server templates page and fix its references

Delete the typescript/server/templates page and repoint the home
templates tip to the quickstart, which now covers create-mcp-use-app.

* docs(typescript): fix dead example links to real example paths

The 'see a full example' links pointed at GitHub folders that 404 or
contain only a README. Corrected to the real runnable examples under
libraries/typescript/packages/mcp-use/examples/, verified against
origin/main (incl. matching cd commands):

- installation: examples/server -> packages/.../examples/server
- client-configuration: a .py link -> real TS multi-server example
- code-mode: examples/client/* -> examples/agent/code-mode/*
- elicitation, sampling, notifications: server/X -> server/features/X
- supabase: server/supabase -> server/deployment/supabase
- clerk: restore missing packages/mcp-use/ path segment

Quickstart links were already fixed by the quickstart rewrite (e6903716).
Part of the docs audit (MCP-2466).

* docs(typescript): rewrite Agent and Client introduction pages

Rewrite the Agent and Client intro pages to be task-oriented and
scannable: concise feature lists with cross-links, runnable quick-start
examples, and added API reference sections. Drop stale CodeSandbox
embeds and outdated model names.

* docs(typescript): fix MCPServer class name casing in server reference

The API Reference heading, prose, and class signature used McpServer;
the real SDK export is MCPServer. Corrected all three occurrences in
server/index.mdx.

* docs: add redirect for bare /typescript/server path

Routes the bare /typescript/server path to its index page now that the
server section has been restructured.

Claude-Session: https://claude.ai/code/session_015uioJjKTAZXGQpbXHUHZWp

* docs(typescript): fix broken code examples across MCP Server & Apps section

Fix all 102 confirmed code defects found in the MCP Server & MCP Apps
documentation audit (47 pages, 401 code blocks), verified against the
mcp-use@1.32 SDK source. The recurring patterns that made copy-pasted
examples fail to compile or run are now corrected everywhere they appeared:

- server.start() -> await server.listen() (no start() method exists)
- bare-object tool returns wrapped in object()/text() response helpers;
  catch blocks renamed so they no longer shadow the error() helper
- prompt messages use role:"user" with typed { type:"text" } content
  instead of the invalid role:"system" + bare-string shape
- auth reads ctx.auth.user.userId (not ctx.auth.userId); user fields live
  under ctx.auth.user, scopes/permissions stay top-level
- security: remove verifyJwt: process.env.NODE_ENV === 'production' from all
  six OAuth provider pages (off-prod it skips signature verification and
  accepts forged tokens); rely on the secure default, with a warning never
  to disable it
- correct import subpaths: Logger/MCPClient from mcp-use, response helpers
  and server symbols from mcp-use/server, MCPClient as BrowserMCPClient from
  mcp-use/browser; drop the unexported getMcpAppsBridge
- useWidget generics use the real <TProps, TState, TOutput, ...> order;
  remove the non-existent notifyIntrinsicHeight (auto-size via McpUseProvider)
- fix the deployment URL to <id>.run.mcp-use.com/mcp, add missing z/helper
  imports, add the --branch/--dockerfile CLI options, and clean up em dashes
  and bare/malformed code fences

Each page was fixed and then independently re-verified against the SDK
source, with a repo-wide pattern sweep confirming no instances remain.
Structural IA changes (moving widget-components to /react/, orphan
redirects) are intentionally deferred to the docs rewrite.

* docs(typescript): restructure MCP Server & MCP Apps IA

Promote MCP Apps to its own top-level section in the TypeScript SDK Docs tab and move the 9 React widget-component pages out of /server/widget-components/ into /typescript/react/.

- Move 9 React component pages to typescript/react/ (git renames) with 9 redirects
- Promote MCP Apps to a top-level group (Overview pages + React subgroup)
- Remove the duplicate MCP Apps group from the Home product nav; rehome guides/chatgpt-apps-flow under MCP Apps so it no longer orphans
- Move cli-reference out of MCP Server into a new Tooling group
- Relocate response-helpers -> Core Components, openapi -> Advanced Features, nextjs-drop-in -> Deployment
- Repoint all widget-components links to /typescript/react/
- Fix 3 broken anchor links (inspector CLI env var, mcp-apps metadata, auth providers)

Structure-only change; no page content rewrites. Refs MCP-2466.

* docs: refresh TypeScript server app docs

* docs: add TypeScript API reference

* docs: streamline TypeScript server navigation

* docs: rewrite core TypeScript server guides

* docs: rewrite advanced TypeScript server guides

* docs: rewrite TypeScript server OAuth guides

* docs: rewrite TypeScript server session storage guides

* docs: rewrite MCP Apps section

* docs: add TypeScript MCP client API reference

* docs: add TypeScript MCP agent API reference

* docs: reorder TypeScript API reference nav

* docs: reorganize TypeScript tooling nav

* docs: rewrite inspector guides

* docs: rewrite MCP server tunneling guide

* docs: rewrite CLI client and reference docs

* docs: finalize TypeScript documentation rewrite

* docs: move inspector updates under get started

* Fix Mintlify validation errors

* Fix Mintlify broken links

* docs: update Manufact Cloud deployment guide

* chore: retrigger Mintlify docs preview

* Fix MDX comment syntax on home page

* docs: rework TypeScript server examples

* docs: fix server docs links

* docs: restore SDK links in home sidebar

* docs: move SDK links to end of home sidebar
 2026-06-29 10:05:13 -07:00
Andrew Khadder 430178c9a3 Canary (#1757) 
* chore(deps): bump hono in /libraries/typescript/packages/mcp-use (#1755)

Bumps [hono](https://github.com/honojs/hono) from 4.12.23 to 4.12.25.
- [Release notes](https://github.com/honojs/hono/releases)
- [Commits](https://github.com/honojs/hono/compare/v4.12.23...v4.12.25)

---
updated-dependencies:
- dependency-name: hono
  dependency-version: 4.12.25
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* chore: enter canary prerelease mode

* chore: add hono changeset

* chore(typescript): version packages (canary)

* Fix Codex skills install path (#1756)

* chore(typescript): version packages (canary)

* chore(deps): bump vite from 8.0.8 to 8.0.16 in /libraries/typescript (#1742)

* chore(deps): bump vite from 8.0.8 to 8.0.16 in /libraries/typescript

Bumps [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite) from 8.0.8 to 8.0.16.
- [Release notes](https://github.com/vitejs/vite/releases)
- [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md)
- [Commits](https://github.com/vitejs/vite/commits/v8.0.16/packages/vite)

---
updated-dependencies:
- dependency-name: vite
  dependency-version: 8.0.16
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

* chore: add changeset for dependabot updates

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* chore(typescript): version packages (canary)

* Handle inspector CLI version and unknown options (#1722)

* Handle inspector CLI version and unknown options

* Keep inspector version in sync with package metadata

---------

Co-authored-by: GhostAOI <232006627+GhostAOI@users.noreply.github.com>
Co-authored-by: Andrew Khadder <andrew@manufact.com>

* chore(typescript): version packages (canary)

* Make MCP Apps primary widget runtime & Apply Host Context Styles (#1739)

* Make MCP Apps primary widget runtime

* Format MCP Apps runtime changes

* Remove unused OpenAI globals event types

* Apply MCP Apps host style variables

* fix host style variable application

* fix(react): avoid light fallback for missing host theme

* Preserve model context when widget state updates

* Remove obsolete MCP Apps runtime theme tests

* Format MCP Apps runtime tests

* chore(typescript): version packages (canary)

* fix(cli): surface GitHub App install URL up front on deploy (#1761)

* fix(cli): surface GitHub App install URL up front on deploy

When `mcp-use deploy` detects the GitHub App is not connected or lacks
access to the target repo, it now prints the install URL before any
prompt. In a non-interactive context (an agent or CI, without `--yes`)
it prints the URL and next steps and exits cleanly instead of hanging on
an unanswerable prompt. Interactive and `--yes` flows are unchanged.

* test(cli): simplify GitHub install-flow tests; tidy deploy no_access branch

- Collapse redundant gitHubInstallUrl cases into one
- Mock `open` and assert the non-interactive path never launches a browser
- Extract a `noAccess` local in promptGitHubInstallation for readability

* fix(cli): unexport internal-only GitHubInstallation type to satisfy knip

GitHubInstallation is only referenced within api.ts (via GitHubConnectionStatus), so the export was dead and failed the knip check.

* fix(cli): unexport internal-only InstallFlowMode type to satisfy knip

InstallFlowMode is only used within deploy.ts as resolveInstallFlowMode's return type; the test imports the function, not the type. Verified with the full `knip --no-progress` run (exit 0), which CI uses.

* chore(typescript): version packages (canary)

* fix(cli): preserve deployment list sort order (#1752)

* fix(cli): preserve deployment list sort order

* chore(cli): add changeset for deployment list sort order fix

---------

Co-authored-by: Andrew Khadder <andrew@manufact.com>

* chore(typescript): version packages (canary)

* fix(inspector): stop prompting signed-in users to log in (MCP-2142) (#1767)

The hosted inspector showed the "free tier — Sign in to increase your
limits" CTA to every managed-LLM visitor, even when already authenticated.

ChatTab now resolves the shared Manufact session via a new useHostedSession
hook (also adopted by HostedUserMenu) and hides the free-tier sign-in/upgrade
chrome for authenticated users. The visibility rule is extracted into a pure
shouldShowFreeTierUpgrade helper with unit tests.

* chore(typescript): version packages (canary)

* fix(typescript): pass the cwd field (#1785)

* fix: pass the cwd field

Signed-off-by: Dr. Carsten Leue <carsten.leue@de.ibm.com>

* fix: add changeset

Signed-off-by: Dr. Carsten Leue <carsten.leue@de.ibm.com>

* doc: add documentation of cwd field

Signed-off-by: Dr. Carsten Leue <carsten.leue@de.ibm.com>

---------

Signed-off-by: Dr. Carsten Leue <carsten.leue@de.ibm.com>
Co-authored-by: Dr. Carsten Leue <carsten.leue@de.ibm.com>

* chore(typescript): version packages (canary)

* fix(inspector): replace stale auto-connect transports (#1792)

* chore(typescript): version packages (canary)

* fix(templates): score 100% on publishing checklist (MCP-2260) (#1772)

* fix(templates): score 100% on publishing checklist (MCP-2260)

Auto-derive openai/widgetDescription from the widget description in the Apps
SDK adapter so hosts always see a widget description, and fill the small
metadata gaps the templates were missing:

- starter: fetch-weather declares a title + outputSchema (returns matching
  structuredContent).
- mcp-apps: search-tools and get-fruit-details declare a title; the
  product-search-result widget declares a domain (widgetDescription is now
  auto-derived from its description).

Adds a unit test for the widgetDescription default.

* feat(server): enforce outputSchema at the tool return position (MCP-2260)

Type-check a tool's outputSchema through the existing object()/widget() calls
with no new API:

- Content helpers (text, markdown, image, ...) now return a content-only
  ToolContentResult (structuredContent?: never), so they're always allowed.
- widget() is generic over its props, which become the result's
  structuredContent — so widget({ props }) is checked against outputSchema.
- The tool callback return type is TypedCallToolResult<TOutput> | ToolContentResult,
  making object({ wrong })/widget({ props: wrong }) a compile-time error.

Adds a type-level test (npm run test:types) and removes an internal template
comment. Edge cases that now error against a tool with outputSchema: mix()
carrying structured content, or a raw literal with a mismatched structuredContent.

* fix(templates): remove hardcoded widget domain

Keep the generated MCP Apps template client-neutral so deployers can set their own production widget origin.

* chore(typescript): update knip.json to include additional ignore patterns and entry points

- Added "test_app" to the ignoreWorkspaces list.
- Included "tests/types/**/*.ts" in the entry patterns for type checking.
- Removed redundant "scripts/**/*.{js,mjs,ts}" from the entry list in the create-mcp-use-app package.

* chore(typescript): version packages (canary)

* feat(cli): expose monorepo auto-deploy trigger config (#1793)

Add --watch-paths/--wait-for-ci to `mcp-use deploy` and
--watch-paths/--deploy-branches/--wait-for-ci/--root-dir to
`mcp-use servers update`, and surface the effective trigger config in
`servers get`/`update`. Closes the gap where the Cloud API accepted
these fields but the CLI could not set them, so monorepo apps can be
scoped to only redeploy on relevant changes (#1547). Updates the
deployment + CLI reference docs accordingly.

* chore(typescript): version packages (canary)

* fix(mcp-use): restore Apps SDK compatibility in useWidget as a fallback (#1794)

Keep the MCP Apps bridge as the primary widget runtime, but use
window.openai (Apps SDK) as a compatibility fallback when the bridge
does not connect, instead of dropping it entirely.

#1739 made the MCP Apps bridge the sole iframe runtime, which left any
Apps SDK-only host (e.g. a ChatGPT widget without MCP Apps support)
stuck on the loading spinner forever. A connected MCP Apps bridge still
always wins, so ChatGPT keeps using MCP Apps as the source of truth.

Also fixes two pre-existing issues in the scroll-to-bottom chat e2e test
(strict-mode locator + measuring the animated scroll synchronously).

* chore(typescript): version packages (canary)

* feat(inspector, typescript): release v11.0.0 and v1.33.0 with MCP Apps as primary widget runtime

- Introduced MCP Apps as the primary widget runtime, enhancing style variable application.
- Fixed issues with auto-connect entries, user prompts for free-tier, and CLI version handling.
- Updated dependencies including `vite` and `mcp-use`.
- Added monorepo auto-deploy controls and improved CLI documentation for new flags.

See changelogs for detailed updates and fixes.

* fix(inspector): scope OAuth proxy fetch per server configuration (#1770)

* fix(inspector): scope OAuth proxy fetch per server configuration

The browser OAuth provider installed a global window.fetch interceptor to
route OAuth requests through the inspector proxy. With multiple servers,
connecting one server "Via Proxy" mutated fetch for the entire page, so other
servers (including "Direct" ones) and unrelated requests were affected, and
switching a server from "Via Proxy" back to "Direct" could leave a stale
interceptor behind.

BrowserOAuthClientProvider now exposes a scoped getProxyFetch() that returns a
fetch confined to a single provider. It is passed only to that server's SDK
transport and auth() calls (via the SDK's fetch / fetchFn options), so
OAuth-proxy behavior is scoped to the selected server's connection and the
global fetch is never mutated.

Closes #1766

Co-authored-by: Cursor <cursoragent@cursor.com>

* chore: remove redundant OAuth cleanup comment

---------

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Andrew Khadder <andrew@manufact.com>

* chore(typescript): version packages (canary)

* Adopt auto connection mode in inspector docs and UI (#1795)

* Adopt auto connection mode in inspector docs and UI

* Fix embedded inspector auto proxy fallback

* chore(typescript): version packages (canary)

* docs: update TypeScript release changelogs

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Dr. Carsten Leue <carsten.leue@de.ibm.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Ghost Monkey <haugun79@gmail.com>
Co-authored-by: GhostAOI <232006627+GhostAOI@users.noreply.github.com>
Co-authored-by: 落尘 <cuidong111@gmail.com>
Co-authored-by: Enrico Toniato <2827496+tonxxd@users.noreply.github.com>
Co-authored-by: Dr. Carsten Leue <55989662+Carsten-Leue@users.noreply.github.com>
Co-authored-by: Dr. Carsten Leue <carsten.leue@de.ibm.com>
Co-authored-by: Hemant Krishnakumar <51333870+hemant1026@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-06-25 18:46:31 -07:00
Enrico Toniato 53ae49d153 Canary (#933) 
* Fix/mcp-use/pending-state (#931)

* feat(inspector): enhance widget support and lifecycle management

- Updated MCPAppsRenderer and OpenAIComponentRenderer to handle tool output and metadata more effectively, allowing for immediate rendering of widgets even when results are pending.
- Implemented pre-fetching of widget resources in ToolsTab to improve loading states and user experience.
- Added utility functions for widget detection and pre-rendering capabilities based on tool metadata.
- Enhanced MessageList and ToolResultRenderer to support immediate rendering of widget tools, improving responsiveness during tool execution.
- Introduced a delayed weather tool in the example server to demonstrate widget lifecycle management.

These changes address Issue #930, ensuring widgets can display loading states and update seamlessly upon tool completion.

* fix(inspector): emulate pending state for widgets to align with ChatGPT behavior

- Added logic to ensure that the pending state is accurately reflected for widgets, enhancing user experience during tool execution.
- Removed unnecessary console logs and warnings in ToolResultRenderer for cleaner code and improved performance.

* feat(server): add delayed weather tool to test widget lifecycle

- Introduced a new tool, `get-weather-delayed`, which simulates a 5-second delay before returning weather data. This addition aims to test and demonstrate the widget lifecycle management, addressing Issue #930.
- Updated documentation to include usage instructions for the new tool, enhancing the example server's functionality.

* docs(inspector): update inspector references and enhance widget lifecycle testing documentation

- Changed references from "MCP Inspector" to "mcp-use Inspector" for consistency.
- Added detailed instructions for testing widget lifecycle, including `isPending` transitions and console log verification.
- Updated links and sections to improve clarity and usability in the documentation.

* feat(inspector): enhance server connection handling in Layout component (#932)

* feat(inspector): enhance server connection handling in Layout component

- Added logic to redirect to the autoConnect parameter if a server URL is provided but no matching connection exists.
- Updated dependencies in the useEffect hook to include connections and navigate for improved functionality.

* feat(inspector): add url-parameters to inspector documentation

- Included "inspector/url-parameters" in the documentation index to enhance the inspector's reference materials.

* chore: enter canary prerelease mode

* chore(typescript): version packages (canary)

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
 2026-02-01 09:48:01 -08:00