mcp-use provides everything you need to build with Model Context Protocol
MCP servers, MCP clients and AI agents in 6 lines of code, in both Python and TypeScript.
mcp-use provides everything you need to build with Model Context Protocol
MCP servers, MCP clients and AI agents in 6 lines of code, in both Python and TypeScript.
π€ Build an AI AgentCreate intelligent agents that can use tools, browse the web, manage files, and more. |
π Use MCP ClientConnect directly to MCP servers and call tools programmatically without an agent. |
π οΈ Create an MCP ServerBuild your own MCP servers with tools, resources, and prompts. |
π Debug with InspectorTest, debug, and explore your MCP servers interactively. |
π¨ Build ChatGPT AppsCreate interactive UIs with mcp-ui, react and live reload. |
βοΈ Deploy to MCP CloudDeploy and manage your MCP agents and servers in the cloud. |
Python
```bash
pip install mcp-use langchain-openai
```
```python
import asyncio
from langchain_openai import ChatOpenAI
from mcp_use import MCPAgent, MCPClient
async def main():
# Configure MCP server
config = {
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
}
}
}
client = MCPClient.from_dict(config)
llm = ChatOpenAI(model="gpt-4o")
agent = MCPAgent(llm=llm, client=client)
result = await agent.run("List all files in the directory")
print(result)
asyncio.run(main())
```
[**β Full Python Agent Documentation**](./libraries/python/README.md#quick-start)
#### 
Typescript
```bash
npm install mcp-use @langchain/openai
```
```typescript
import { ChatOpenAI } from "@langchain/openai";
import { MCPAgent, MCPClient } from "mcp-use";
async function main() {
// Configure MCP server
const config = {
mcpServers: {
filesystem: {
command: "npx",
args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
},
},
};
const client = MCPClient.fromDict(config);
const llm = new ChatOpenAI({ modelName: "gpt-4o" });
const agent = new MCPAgent({ llm, client });
const result = await agent.run("List all files in the directory");
console.log(result);
}
main();
```
[**β Full TypeScript Agent Documentation**](./libraries/typescript/README.md#-quick-start)
---
### Use MCP Client
Connect to MCP servers directly without an AI agent for programmatic tool access.
#### Python
```python
import asyncio
from mcp_use import MCPClient
async def main():
config = {
"mcpServers": {
"calculator": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-everything"]
}
}
}
client = MCPClient.from_dict(config)
await client.create_all_sessions()
session = client.get_session("calculator")
result = await session.call_tool(name="add", arguments={"a": 5, "b": 3})
print(f"Result: {result.content[0].text}")
await client.close_all_sessions()
asyncio.run(main())
```
[**β Python Client Documentation**](./libraries/python/README.md#direct-tool-calls-without-llm)
#### Typescript
```typescript
import { MCPClient } from "mcp-use";
async function main() {
const config = {
mcpServers: {
calculator: {
command: "npx",
args: ["-y", "@modelcontextprotocol/server-everything"],
},
},
};
const client = new MCPClient(config);
await client.createAllSessions();
const session = client.getSession("calculator");
const result = await session.callTool("add", { a: 5, b: 3 });
console.log(`Result: ${result.content[0].text}`);
await client.closeAllSessions();
}
main();
```
[**β TypeScript Client Documentation**](./libraries/typescript/README.md#basic-usage)
---
### Create an MCP Server
Build your own MCP server with custom tools, resources, and prompts.
#### Typescript
```bash
npx create-mcp-use-app my-server
cd my-server
npm install
```
```typescript
import { MCPServer, text } from "mcp-use/server";
import { z } from "zod";
const server = new MCPServer({
name: "my-server",
version: "1.0.0",
description: "My custom MCP server",
});
// Define a tool
server.tool(
{
name: "get_weather",
description: "Get weather for a city",
schema: z.object({
city: z.string().describe("City name"),
}),
},
async ({ city }) => {
return text(`Temperature: 72Β°F, Condition: sunny, City: ${city}`);
}
);
// Start server with auto-inspector
server.listen(3000);
// π Inspector at http://localhost:3000/inspector
```
[**β Full TypeScript Server Documentation**](./libraries/typescript/README.md#%EF%B8%8F-mcp-server-framework)
#### Python
**Coming Soon!** For now, please use the TypeScript implementation to create MCP servers.
---
### Use the Inspector
Debug and test your MCP servers with the interactive web-based inspector.
#### Automatic (with mcp-use server)
When you create a server with `mcp-use`, the inspector is automatically available:
```typescript
server.listen(3000);
// Inspector automatically at: http://localhost:3000/inspector
```
#### Standalone
Inspect any MCP server via CLI:
```bash
npx @mcp-use/inspector --url http://localhost:3000/sse
```
**Features:**
- π Test tools interactively with live execution
- π Monitor connection status and server health
- π Handle OAuth flows automatically
- πΎ Persistent sessions with localStorage
[**β Full Inspector Documentation**](./libraries/typescript/packages/inspector/README.md)
---
## π More Examples & Documentation
### Example Use Cases
- **[Web Browsing with Playwright](./libraries/python/README.md#web-browsing-with-playwright)** - Automate browser tasks
- **[Multi-Server Setup](./libraries/python/README.md#multi-server-support)** - Use multiple MCP servers together
- **[Streaming Responses](./libraries/python/README.md#streaming-agent-output)** - Real-time agent output
- **[UI Widgets](./libraries/typescript/README.md#building-custom-ui-widgets)** - Build interactive React components
- **[AI SDK Integration](./libraries/typescript/README.md#-ai-sdk-integration)** - Vercel AI SDK for Next.js apps
### Complete Documentation
- **[π Python Documentation](./libraries/python/README.md)** - Complete Python guide
- **[π TypeScript Documentation](./libraries/typescript/README.md)** - Complete TypeScript guide
- **[π Inspector Documentation](./libraries/typescript/packages/inspector/README.md)** - Inspector guide
- **[π Online Docs](https://mcp-use.com/docs)** - Full online documentation
---
## β¨ Key Features
| Feature | Description | Python | TypeScript |
|---|---|---|---|
| π€ MCP Agents | AI agents with tool access and multi-step reasoning | β | β |
| π MCP Clients | Direct connection to any MCP server | β | β |
| π οΈ MCP Servers | Build custom MCP servers | π | β |
| π Inspector | Web-based debugging tool | β | β |
| π¨ UI Widgets | Build interactive React UIs | β | β |
| π Multi-Server | Connect to multiple servers simultaneously | β | β |
| π‘ Streaming | Real-time streaming responses | β | β |
| π Observability | Built-in Langfuse integration | β | β |
| π OAuth Support | Built-in OAuth flow handling | β | β |
| π‘οΈ Tool Control | Restrict access to specific tools | β | β |