{"library":"mcp-use","title":"MCP Use Framework","description":"mcp-use is a full-stack Python framework for building Multi-Cloud Platform (MCP) agents, clients, and servers. It simplifies the development of distributed systems with a focus on asynchronous communication. The current version is 1.7.0 and it maintains an active release cadence, frequently adding features and improvements.","language":"python","status":"active","last_verified":"Sat May 16","install":{"commands":["pip install mcp-use"],"cli":null},"imports":["from mcp_use import Agent","from mcp_use import Client","from mcp_use import Server","from mcp_use import Channel"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import asyncio\nfrom mcp_use import Agent, Client, Server, Channel\n\nasync def main():\n    # Example: A simple MCP Agent and Client interaction\n\n    # 1. Start a simple Agent\n    class MyAgent(Agent):\n        async def handle_message(self, message: str) -> str:\n            print(f\"Agent received: {message}\")\n            return f\"Agent processed: {message.upper()}\"\n\n    agent = MyAgent(name=\"test-agent\", host=\"127.0.0.1\", port=8000)\n    agent_task = asyncio.create_task(agent.start())\n\n    await asyncio.sleep(0.5) # Give agent time to start\n\n    # 2. Connect a Client to the Agent\n    client = Client(name=\"test-client\", host=\"127.0.0.1\", port=8000)\n    await client.connect()\n\n    # 3. Send a message via a Channel\n    try:\n        async with client.channel(\"my-channel\") as channel:\n            response = await channel.send(\"hello mcp!\")\n            print(f\"Client received: {response}\")\n\n            assert response == \"Agent processed: HELLO MCP!\"\n\n    finally:\n        # 4. Clean up\n        await client.disconnect()\n        agent_task.cancel()\n        await agent.stop()\n        print(\"Cleanup complete.\")\n\nif __name__ == \"__main__\":\n    asyncio.run(main())\n","lang":"python","description":"This quickstart demonstrates how to set up a basic MCP Agent and a Client using `mcp-use`. The Agent defines a message handler, the Client connects to it, and they communicate via a named Channel. It showcases the core asynchronous nature and connection management.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-16","installed_version":"1.7.0","pypi_latest":"1.7.0","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":60,"avg_install_s":10.8,"avg_import_s":null,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"mcp-use","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"mcp-use","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":1.5,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"mcp-use","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"127.3M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"mcp-use","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":12.3,"import_time_s":null,"mem_mb":null,"disk_size":"135M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"mcp-use","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"117.2M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"mcp-use","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":10,"import_time_s":null,"mem_mb":null,"disk_size":"125M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"mcp-use","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"117.0M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"mcp-use","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":10.2,"import_time_s":null,"mem_mb":null,"disk_size":"124M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"mcp-use","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"mcp-use","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":1.6,"import_time_s":null,"mem_mb":null,"disk_size":null}]}}