mcp-use provides everything you need to build withModel Context Protocol
MCP servers, MCP clients and AI agents in 6 lines of code, in bothPython andTypeScript.

Stack

🚀 What Do You Want to Build?

📦 Quick Start

Build an AI Agent

Python

pip install mcp-use langchain-openai

importasynciofromlangchain_openaiimportChatOpenAIfrommcp_useimportMCPAgent,MCPClientasyncdefmain():# Configure MCP serverconfig= {"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=awaitagent.run("List all files in the directory")print(result)asyncio.run(main())

Typescript

npm install mcp-use @langchain/openai

import{ChatOpenAI}from"@langchain/openai";import{MCPAgent,MCPClient}from"mcp-use";asyncfunctionmain(){// Configure MCP serverconstconfig={mcpServers:{filesystem:{command:"npx",args:["-y","@modelcontextprotocol/server-filesystem","/tmp"],},},};constclient=MCPClient.fromDict(config);constllm=newChatOpenAI({modelName:"gpt-4o"});constagent=newMCPAgent({ llm, client});constresult=awaitagent.run("List all files in the directory");console.log(result);}main();

Use MCP Client

Python

importasynciofrommcp_useimportMCPClientasyncdefmain():config= {"mcpServers": {"calculator": {"command":"npx","args": ["-y","@modelcontextprotocol/server-everything"]            }        }    }client=MCPClient.from_dict(config)awaitclient.create_all_sessions()session=client.get_session("calculator")result=awaitsession.call_tool(name="add",arguments={"a":5,"b":3})print(f"Result:{result.content[0].text}")awaitclient.close_all_sessions()asyncio.run(main())

Typescript

import{MCPClient}from"mcp-use";asyncfunctionmain(){constconfig={mcpServers:{calculator:{command:"npx",args:["-y","@modelcontextprotocol/server-everything"],},},};constclient=newMCPClient(config);awaitclient.createAllSessions();constsession=client.getSession("calculator");constresult=awaitsession.callTool("add",{a:5,b:3});console.log(`Result:${result.content[0].text}`);awaitclient.closeAllSessions();}main();

Create an MCP Server

Typescript

npx create-mcp-use-app my-servercd my-servernpm install

import{createMCPServer}from"mcp-use/server";import{z}from"zod";constserver=createMCPServer("my-server",{version:"1.0.0",description:"My custom MCP server",});// Define a toolserver.tool("get_weather",{description:"Get weather for a city",parameters:z.object({city:z.string().describe("City name"),}),execute:async({ city})=>{return{temperature:72,condition:"sunny", city};},});// Start server with auto-inspectorserver.listen(3000);// 🎉 Inspector at http://localhost:3000/inspector

Python

Use the Inspector

Automatic (with mcp-use server)

server.listen(3000);// Inspector automatically at: http://localhost:3000/inspector

Standalone

npx @mcp-use/inspector --url http://localhost:3000/sse

📚 More Examples & Documentation

Example Use Cases

Complete Documentation

✨ Key Features

📦 Package Overview

Python Packages

TypeScript Packages

🏗️ Repository Structure

mcp-use/├── libraries/│   ├── python/              → Python implementation│   │   ├── mcp_use/         → Core library│   │   ├── examples/        → Python examples│   │   └── docs/            → Python documentation│   ││   └── typescript/          → TypeScript implementation│       └── packages/│           ├── mcp-use/     → Core framework│           ├── cli/         → Build tool│           ├── inspector/   → Web inspector│           └── create-mcp-use-app/  → Scaffolding└── README.md               → This file

🌟 Why MCP-Use?

Complete Vertical Stack

Language Flexibility

Production Ready

Developer Experience

Open Source

🤝 Community & Support

📜 License

🙏 Contributing

⭐ Star History

📝 Citation

@software{mcp_use2025,author ={Zullo, Pietro and Contributors},title ={MCP-Use: Complete MCP Ecosystem for Python and TypeScript},year ={2025},publisher ={GitHub},url ={https://github.com/mcp-use/mcp-use}}

Contributors

Core Contributors