Skip to content
@mcp-use

mcp-use

Open source dev-tools and infra for MCP (model context protocol)
mcp use logo

mcp-use

🌐 MCP-Use is the open source way to connect any LLM to any MCP server and build custom agents that have tool access, without using closed source or application clients.

🧐 What is mcp-use?

mcp-use is an open source library that enables developers to connect any LLM to any MCP server, allowing the creation of custom agents with tool access without relying on closed-source or application-specific clients.

✨ Just like this

Here's a quick example of how you can use mcp-use:

import asyncio
from langchain_openai import ChatOpenAI
from mcp-use import MCPAgent, MCPClient

async def main():
    client = MCPClient(config= {"mcpServers":{
    "playwright": {
        "command": "npx",
        "args": ["@playwright/mcp@latest"],
        "env": {"DISPLAY": ":1"}
    }}})
    # Create LLM
    llm = ChatOpenAI(model="gpt-4o", api_key=...)
    # Create agent with tools
    agent = MCPAgent(llm=llm, client=client, max_steps=30)
    # Run the query
    result = await agent.run("Find the best restaurant in San Francisco")

if __name__ == "__main__":
    asyncio.run(main())

➡️ Create your own with our Builder

🚀 Key Features

  • 💻 Open Source: Connect any LLM to any MCP server without vendor lock-in.
  • ⚙️ Flexible Configuration: Support for any MCP server through a simple configuration system.
  • ⚙️ Easy Setup: Simple JSON-based configuration for MCP server integration.
  • 🤖 Universal LLM Support: Compatible with any LangChain-supported LLM provider.
  • 🔌 HTTP Connection: Connect to MCP servers running on specific HTTP ports for web-based integrations.
  • 🔀 Dynamic Server Selection: Agents can dynamically choose the most appropriate MCP server for the task.

🏁 Getting Started


We are constantly working to improve mcp-use. Check out what we're planning and suggest new features!

Pinned Loading

  1. mcp-use mcp-use Public

    mcp-use is the easiest way to interact with mcp servers with custom agents

    TypeScript 8.1k 945

Repositories

Showing 10 of 10 repositories
  • mcp-use Public

    mcp-use is the easiest way to interact with mcp servers with custom agents

    mcp-use/mcp-use’s past year of commit activity
    TypeScript 8,103 MIT 945 28 (3 issues need help) 6 Updated Oct 29, 2025
  • ray-so Public Forked from raycast/ray-so

    Create code snippets, browse AI prompts, create extension icons and more.

    mcp-use/ray-so’s past year of commit activity
    TypeScript 0 MIT 275 0 0 Updated Oct 28, 2025
  • mcp-use-ts Public

    mcp-use is the framework for MCP with the best DX - Build AI agents, create MCP servers with UI widgets, and debug with built-in inspector. Includes client SDK, server SDK, React hooks, and powerful dev tools.

    mcp-use/mcp-use-ts’s past year of commit activity
    TypeScript 154 28 5 (1 issue needs help) 20 Updated Oct 27, 2025
  • app-sdk-template Public

    MCP server for OpenAI Apps SDK with 5 pizzaz widgets demonstrating best practices: external resources, CSP, tool invocation status, and structured content injection. Built with mcp-use.

    mcp-use/app-sdk-template’s past year of commit activity
    TypeScript 0 0 0 0 Updated Oct 24, 2025
  • .github Public

    Readme file for mcp-use

    mcp-use/.github’s past year of commit activity
    0 0 0 0 Updated Oct 23, 2025
  • inspector Public Forked from modelcontextprotocol/inspector

    Visual testing tool for MCP servers

    mcp-use/inspector’s past year of commit activity
    TypeScript 1 MIT 945 0 0 Updated Sep 28, 2025
  • server_template_python Public

    This repo is a template for server deployment

    mcp-use/server_template_python’s past year of commit activity
    Python 1 0 0 0 Updated Sep 19, 2025
  • mcp-use/mcp-use-elastic-hack-a-night’s past year of commit activity
    Python 6 14 0 0 Updated Aug 20, 2025
  • mcp-use-cli Public

    mcp-use powered CLI to connect to any MCP server with any LLM, from your terminal

    mcp-use/mcp-use-cli’s past year of commit activity
    TypeScript 44 MIT 5 2 1 Updated Jul 1, 2025
  • mcp-use-voice-assistant Public

    MCP Voice assistant powered by mcp-use

    mcp-use/mcp-use-voice-assistant’s past year of commit activity
    Python 18 5 1 0 Updated Jun 25, 2025