mcp-use
Write an MCP server in TypeScript, bind React views to its tools, and inspect the result in a browser before shipping
What is mcp-use?
Most MCP servers return text and leave the client to render it. mcp-use is built around the opposite idea: a tool can carry a React view, so what the user sees inside ChatGPT or Claude is an interface rather than a paragraph. Tool inputs and outputs are declared with Zod schemas and those types flow through to the view's props, so a change in one place shows up as a type error in the other. A scaffolded project comes with an inspector at a local URL for calling tools and looking at views while you work, and a tunnel for testing against a real client. Version 2 is a rewrite around this server-and-view model; the earlier Python client library is no longer where the project's attention is.
What can you do with mcp-use?
- Start from a working server, not an empty file — One command scaffolds the server, the build setup, a sample tool and the inspector, so the first run happens before any decisions are made.
- One schema, checked everywhere — Tool inputs and outputs are declared once with Zod, and those types reach the structured result and the view's props — a mismatch is a type error.
- Return a screen instead of a paragraph — A tool can name a React view, and the client renders that view with the tool's result, so the user can click and refresh rather than read.
- Try the tool before the client sees it — A browser inspector calls tools and renders views against the running server, and the same checks can be run from the terminal for CI.
- Test against a real client over a tunnel — A public URL for the local server lets you connect ChatGPT or Claude to work in progress without deploying anything.
Before you choose mcp-use
- Version 2 is a rewrite rather than an upgrade: the project ships a migration guide, and code and articles written for version 1 — including its Python client library — do not carry across.
- The deploy step points at the maintainers' own hosted platform, which is where the observability and analytics live; running the server elsewhere is possible but is not the documented path.
Star history
27 Aug to 30 Oct · +301
Frequently asked questions
Is mcp-use free for commercial use?
mcp-use is released under the MIT licence — OSI-approved open source, which permits commercial use.
How can mcp-use be deployed?
mcp-use is available as Self-hosted / Runs locally / Managed cloud.