mcp-use weekly downloads statistics

The TypeScript framework for MCP

Build, test, and ship MCP servers, ChatGPT plugins, Claude connectors

Fully Typed, native Views and MCP Apps support, built-in Inspector and first class Agent experience.

Documentation · Inspector · Examples · Deploy

[!NOTE] Migrating from v1? Give it to your agent:

Read the migration guide →

Get started

Start with your agent

Read the prompt →

Start with code

Run npm run dev in the generated project · open http://localhost:3000/mcp/inspector

TS Docs

Everything you need to ship MCP

Fully typed

Zod schemas flow from tools to structured results, View props, and tool calls.

Native Views

Bind React Views directly to tools and ship interactive apps without custom extension wiring.

Agent-first and headless

Scaffold, invoke, inspect, screenshot, and deploy through your agent.

Built-in debugging tools

Inspect tools and Views in the browser or headlessly through the CLI.

Quickstart

The scaffold gives you the server, TypeScript configuration, development scripts, Inspector, and a React view pipeline. Start it once and the MCP endpoint also serves a client-ready landing page with its connection URL and setup instructions.

Replace its index.ts with a view-bound tool like this:

index.ts — Server entry file for tool definition and metadata

Explore MCP server tools →

Add Views to your tools

Create views/weather-card/view.tsx. The directory name matches view.name on the tool:

view.tsx — Return a view from your tools: React weather card

Build interactive UI experiences within ChatGPT with mcp-use.

Build your first MCP App →

Build

Create the production build:

Inspect

Start development mode to serve the MCP endpoint at http://localhost:3000/mcp. The Inspector is automatically available at http://localhost:3000/mcp/inspector:

Invoke tools, validate inputs, and inspect interactive Views in the same development loop.

Start a tunnel from the Inspector UI or run mcp-use dev --tunnel to get a public URL for your local MCP server and test it with ChatGPT and Claude before deployment. Learn more about tunneling →

Inspect the same server headlessly from the terminal, invoke representative tools, and capture a View screenshot:

Deploy

Ship to Manufact and get observability, analytics, evals, submission readiness, and Git-based preview environments for free.

Prefer to run it yourself? Follow the self-hosting guide →.

How mcp-use compares

mcp-use builds on the official TypeScript SDK v2 and adds first-class Views, typed tool-to-UI contracts, an optimized stateless runtime, the Inspector, screenshot verification, agent-first CLI workflows, and deployment.

* Includes @modelcontextprotocol/ext-apps, Vite, and zod for an MCP Apps-capable stack.

Install rows compare custom React MCP App development stacks. FastMCP therefore includes the Apps extension, React, Vite React plugin, Vite, TypeScript, and zod rather than only its narrower server-side component workflow. Size is actual node_modules disk usage after a normal npm install, including required peer dependencies.

Read the detailed benchmark report →

Examples

Remix a complete MCP App, inspect the source, or deploy it as a starting point:

| Preview | App | What it demonstrates |

| | Chart Builder | Structured data rendered as interactive charts · Open demo | | | Diagram Builder | Create and edit diagrams through MCP tools · Open demo | | | Maps Explorer | Search, detail tools, and an interactive map view · Open demo |

Browse all TypeScript examples →

Ecosystem

| Package | Use it for |

| mcp-use | TypeScript v2 server framework, React views, and CLI | | @mcp-use/client | Connect to MCP servers from Node.js, browsers, React, and sandboxes | | @mcp-use/agent | Build model-powered agents on top of MCP clients | | @mcp-use/inspector | Inspect and debug MCP servers and apps | | @mcp-use/tunnel | Expose local HTTP, WebSocket, and MCP servers through the managed relay | | create-mcp-use-app | Scaffold servers and interactive apps | | mcp-use for Python | Build Python MCP servers, clients, and agents |

• TypeScript documentation • Python documentation • Inspector documentation • Agent documentation • Client documentation

Protocol conformance

Security and community

• Security policy • Contribution guide • GitHub issues • Discord community • Manufact • MIT license

Contributors

Built by Pietro, Luigi, Enrico, and the mcp-use community.

Description from the npm listing.