mcp-use 1.3.11__tar.gz → 1.3.13__tar.gz

{mcp_use-1.3.11 → mcp_use-1.3.13}/.pre-commit-config.yaml

@@ -4,10 +4,9 @@ repos:
     rev: v0.3.2
     hooks:
     -   id: ruff
-        args: [--fix, --exit-non-zero-on-fix, --config=ruff.toml]
+        args: [--fix, --exit-non-zero-on-fix]
         types: [python]
     -   id: ruff-format
-        args: [--config=ruff.toml]
         types: [python]
 
 -   repo: https://github.com/pre-commit/pre-commit-hooks

{mcp_use-1.3.11 → mcp_use-1.3.13}/PKG-INFO

@@ -1,10 +1,9 @@
 Metadata-Version: 2.4
 Name: mcp-use
-Version: 1.3.11
+Version: 1.3.13
 Summary: MCP Library for LLMs
-Author-email: Pietro Zullo <pietro.zullo@gmail.com>
+Author-email: "mcp-use, Inc." <dev@mcp-use.io>, Pietro Zullo <pietro.zullo@gmail.com>
 License: MIT
-License-File: LICENSE
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -17,10 +16,12 @@ Requires-Python: >=3.11
 Requires-Dist: aiohttp>=3.9.0
 Requires-Dist: authlib>=1.6.3
 Requires-Dist: jsonschema-pydantic>=0.1.0
-Requires-Dist: langchain>=0.1.0
+Requires-Dist: langchain-core==0.3.79
+Requires-Dist: langchain==0.3.27
 Requires-Dist: mcp>=1.10.0
 Requires-Dist: posthog>=4.8.0
-Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydantic-core==2.33.2
+Requires-Dist: pydantic==2.11.10
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: scarf-sdk>=0.1.0
 Requires-Dist: websockets>=15.0
@@ -53,8 +54,7 @@ Description-Content-Type: text/markdown
   </picture>
 </div>
 
-
-<h1 align="center">🚀 Create MCP Clients and Agents</h1>
+<h1 align="center">🚀 MCP-Use for Python</h1>
 <p align="center">
     <a href="https://github.com/pietrozullo/mcp-use/stargazers" alt="GitHub stars">
         <img src="https://img.shields.io/github/stars/pietrozullo/mcp-use?style=social" /></a>
@@ -62,37 +62,42 @@ Description-Content-Type: text/markdown
         <img src="https://static.pepy.tech/badge/mcp-use" /></a>
     <a href="https://pypi.org/project/mcp_use/" alt="PyPI Version">
         <img src="https://img.shields.io/pypi/v/mcp_use.svg"/></a>
-    <a href="https://github.com/mcp-use/mcp-use-ts" alt="TypeScript">
-      <img src="https://img.shields.io/badge/TypeScript-mcp--use-3178C6?logo=typescript&logoColor=white" /></a>
     <a href="https://github.com/pietrozullo/mcp-use/blob/main/LICENSE" alt="License">
         <img src="https://img.shields.io/github/license/pietrozullo/mcp-use" /></a>
     <a href="https://docs.mcp-use.com" alt="Documentation">
         <img src="https://img.shields.io/badge/docs-mcp--use.com-blue" /></a>
-    <a href="https://mcp-use.com" alt="Website">
-        <img src="https://img.shields.io/badge/website-mcp--use.com-blue" /></a>
-    </p>
-    <p align="center">
-    <a href="https://x.com/pietrozullo" alt="Twitter Follow - Pietro">
-        <img src="https://img.shields.io/twitter/follow/Pietro?style=social" /></a>
-    <a href="https://x.com/pederzh" alt="Twitter Follow - Luigi">
-        <img src="https://img.shields.io/twitter/follow/Luigi?style=social" /></a>
     <a href="https://discord.gg/XkNkSkMz3V" alt="Discord">
         <img src="https://dcbadge.limes.pink/api/server/XkNkSkMz3V?style=flat" /></a>
 </p>
 </div>
 
-🌐 MCP-Use is the open source way to connect **any LLM to any MCP server** and build custom MCP agents that have tool access, without using closed source or application clients.
+> **📦 Part of the [MCP-Use Monorepo](../../README.md)** - This is the Python implementation. Also available in [TypeScript](../typescript/README.md).
+
+🌐 **MCP-Use for Python** is the complete way to connect **any LLM to any MCP server** and build custom MCP agents with tool access.
+
+💡 Let your Python applications leverage the power of the Model Context Protocol with support for agents, clients, and advanced features.
+
+## 🏗️ What's Included
+
+MCP-Use for Python provides three main capabilities:
+
+- **🤖 MCP Agent** - Build AI agents that can use tools and reason across multiple steps
+- **🔌 MCP Client** - Connect directly to MCP servers for programmatic tool access
+- **🛠️ MCP Server** - _Coming soon!_ For now, use the [TypeScript version](../typescript/README.md#%EF%B8%8F-mcp-server-framework)
 
-💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
+---
 
-- If you want to get started quickly check out [mcp-use.com website](https://mcp-use.com/) to build and deploy agents with your favorite MCP servers.
-- Visit the [mcp-use docs](https://docs.mcp-use.com/) to get started with mcp-use library
-- For the TypeScript version, visit [mcp-use-ts](https://github.com/mcp-use/mcp-use-ts)
+## 📖 Quick Links
 
-| Supports       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+- **[Main Repository](../../README.md)** - Overview of the entire MCP-Use ecosystem
+- **[TypeScript Version](../typescript/README.md)** - TypeScript implementation with server framework
+- **[Documentation](https://docs.mcp-use.com)** - Complete online documentation
+- **[Examples](./examples/)** - Python code examples
+
+| Supports       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **Primitives** | [![Tools](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-tools&label=Tools&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Resources](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-resources&label=Resources&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Prompts](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-prompts&label=Prompts&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Sampling](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-sampling&label=Sampling&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Elicitation](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-elicitation&label=Elicitation&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Authentication](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-authentication&label=Authentication&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
-| **Transports** | [![Stdio](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-stdio&label=Stdio&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![SSE](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-sse&label=SSE&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Streamable HTTP](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-streamableHttp&label=Streamable%20HTTP&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml)                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| **Transports** | [![Stdio](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-stdio&label=Stdio&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![SSE](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-sse&label=SSE&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Streamable HTTP](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-streamableHttp&label=Streamable%20HTTP&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 
 ## Features
 
@@ -139,7 +144,13 @@ Description-Content-Type: text/markdown
   </tr>
 </table>
 
-# Quick start
+---
+
+# 🤖 MCP Agent
+
+The **MCP Agent** is an AI-powered agent that can use tools from MCP servers to accomplish complex tasks. It reasons across multiple steps, selecting and executing tools as needed.
+
+## Quick Start
 
 With pip:
 
@@ -674,7 +685,13 @@ The `SandboxOptions` type provides configuration for the sandbox environment:
 - **Consistent environment**: Ensure consistent behavior across different systems
 - **Resource efficiency**: Offload resource-intensive tasks to cloud infrastructure
 
-# Direct Tool Calls (Without LLM)
+---
+
+# 🔌 MCP Client
+
+The **MCP Client** allows you to connect directly to MCP servers and call tools programmatically without an AI agent. This is useful when you know exactly which tools to call and don't need AI reasoning.
+
+## Direct Tool Calls (Without LLM)
 
 You can call MCP server tools directly without an LLM when you need programmatic control:
 
@@ -751,6 +768,23 @@ if __name__ == "__main__":
 
 ```
 
+---
+
+# 🛠️ MCP Server
+
+**Coming Soon!** Python support for creating MCP servers is under development.
+
+In the meantime, you can create MCP servers using our [TypeScript implementation](../typescript/README.md#%EF%B8%8F-mcp-server-framework), which offers:
+
+- Complete server framework with tools, resources, and prompts
+- Built-in inspector for debugging
+- React-based UI widgets for interactive experiences
+- Hot reload development workflow
+
+Python agents and clients can connect to TypeScript servers seamlessly - the MCP protocol is language-agnostic.
+
+---
+
 # Debugging
 
 MCP-Use provides a built-in debug mode that increases log verbosity and helps diagnose issues in your agent implementation.
@@ -814,14 +848,6 @@ This is useful when you only need to see the agent's steps and decision-making p
 
 We love contributions! Feel free to open issues for bugs or feature requests. Look at [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
-## Contributors
-
-Thanks to all our amazing contributors!
-
-<a href="https://github.com/mcp-use/mcp-use/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=mcp-use/mcp-use" />
-</a>
-
 ## Top Starred Dependents
 
 <!-- gh-dependents-info-used-by-start -->
@@ -833,23 +859,23 @@ Thanks to all our amazing contributors!
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/38653995?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/patchy631/ai-engineering-hub"><strong>patchy631/ai-engineering-hub</strong></a></td>
-    <td>⭐ 17917</td>
+    <td>⭐ 18021</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/164294848?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/buildfastwithai/gen-ai-experiments"><strong>buildfastwithai/gen-ai-experiments</strong></a></td>
-    <td>⭐ 178</td>
+    <td>⭐ 202</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/187057607?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/hud-evals/hud-python"><strong>hud-evals/hud-python</strong></a></td>
-    <td>⭐ 159</td>
+    <td>⭐ 168</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/170207473?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/tavily-ai/meeting-prep-agent"><strong>tavily-ai/meeting-prep-agent</strong></a></td>
-    <td>⭐ 136</td>
+    <td>⭐ 138</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/20041231?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/krishnaik06/MCP-CRASH-Course"><strong>krishnaik06/MCP-CRASH-Course</strong></a></td>
-    <td>⭐ 72</td>
+    <td>⭐ 74</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/54944174?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/larksuite/lark-samples"><strong>larksuite/lark-samples</strong></a></td>

{mcp_use-1.3.11 → mcp_use-1.3.13}/README.md

@@ -7,8 +7,7 @@
   </picture>
 </div>
 
-
-<h1 align="center">🚀 Create MCP Clients and Agents</h1>
+<h1 align="center">🚀 MCP-Use for Python</h1>
 <p align="center">
     <a href="https://github.com/pietrozullo/mcp-use/stargazers" alt="GitHub stars">
         <img src="https://img.shields.io/github/stars/pietrozullo/mcp-use?style=social" /></a>
@@ -16,37 +15,42 @@
         <img src="https://static.pepy.tech/badge/mcp-use" /></a>
     <a href="https://pypi.org/project/mcp_use/" alt="PyPI Version">
         <img src="https://img.shields.io/pypi/v/mcp_use.svg"/></a>
-    <a href="https://github.com/mcp-use/mcp-use-ts" alt="TypeScript">
-      <img src="https://img.shields.io/badge/TypeScript-mcp--use-3178C6?logo=typescript&logoColor=white" /></a>
     <a href="https://github.com/pietrozullo/mcp-use/blob/main/LICENSE" alt="License">
         <img src="https://img.shields.io/github/license/pietrozullo/mcp-use" /></a>
     <a href="https://docs.mcp-use.com" alt="Documentation">
         <img src="https://img.shields.io/badge/docs-mcp--use.com-blue" /></a>
-    <a href="https://mcp-use.com" alt="Website">
-        <img src="https://img.shields.io/badge/website-mcp--use.com-blue" /></a>
-    </p>
-    <p align="center">
-    <a href="https://x.com/pietrozullo" alt="Twitter Follow - Pietro">
-        <img src="https://img.shields.io/twitter/follow/Pietro?style=social" /></a>
-    <a href="https://x.com/pederzh" alt="Twitter Follow - Luigi">
-        <img src="https://img.shields.io/twitter/follow/Luigi?style=social" /></a>
     <a href="https://discord.gg/XkNkSkMz3V" alt="Discord">
         <img src="https://dcbadge.limes.pink/api/server/XkNkSkMz3V?style=flat" /></a>
 </p>
 </div>
 
-🌐 MCP-Use is the open source way to connect **any LLM to any MCP server** and build custom MCP agents that have tool access, without using closed source or application clients.
+> **📦 Part of the [MCP-Use Monorepo](../../README.md)** - This is the Python implementation. Also available in [TypeScript](../typescript/README.md).
+
+🌐 **MCP-Use for Python** is the complete way to connect **any LLM to any MCP server** and build custom MCP agents with tool access.
+
+💡 Let your Python applications leverage the power of the Model Context Protocol with support for agents, clients, and advanced features.
+
+## 🏗️ What's Included
+
+MCP-Use for Python provides three main capabilities:
+
+- **🤖 MCP Agent** - Build AI agents that can use tools and reason across multiple steps
+- **🔌 MCP Client** - Connect directly to MCP servers for programmatic tool access
+- **🛠️ MCP Server** - _Coming soon!_ For now, use the [TypeScript version](../typescript/README.md#%EF%B8%8F-mcp-server-framework)
 
-💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
+---
 
-- If you want to get started quickly check out [mcp-use.com website](https://mcp-use.com/) to build and deploy agents with your favorite MCP servers.
-- Visit the [mcp-use docs](https://docs.mcp-use.com/) to get started with mcp-use library
-- For the TypeScript version, visit [mcp-use-ts](https://github.com/mcp-use/mcp-use-ts)
+## 📖 Quick Links
 
-| Supports       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+- **[Main Repository](../../README.md)** - Overview of the entire MCP-Use ecosystem
+- **[TypeScript Version](../typescript/README.md)** - TypeScript implementation with server framework
+- **[Documentation](https://docs.mcp-use.com)** - Complete online documentation
+- **[Examples](./examples/)** - Python code examples
+
+| Supports       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **Primitives** | [![Tools](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-tools&label=Tools&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Resources](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-resources&label=Resources&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Prompts](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-prompts&label=Prompts&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Sampling](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-sampling&label=Sampling&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Elicitation](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-elicitation&label=Elicitation&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Authentication](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-authentication&label=Authentication&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
-| **Transports** | [![Stdio](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-stdio&label=Stdio&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![SSE](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-sse&label=SSE&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Streamable HTTP](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-streamableHttp&label=Streamable%20HTTP&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml)                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| **Transports** | [![Stdio](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-stdio&label=Stdio&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![SSE](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-sse&label=SSE&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Streamable HTTP](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-streamableHttp&label=Streamable%20HTTP&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 
 ## Features
 
@@ -93,7 +97,13 @@
   </tr>
 </table>
 
-# Quick start
+---
+
+# 🤖 MCP Agent
+
+The **MCP Agent** is an AI-powered agent that can use tools from MCP servers to accomplish complex tasks. It reasons across multiple steps, selecting and executing tools as needed.
+
+## Quick Start
 
 With pip:
 
@@ -628,7 +638,13 @@ The `SandboxOptions` type provides configuration for the sandbox environment:
 - **Consistent environment**: Ensure consistent behavior across different systems
 - **Resource efficiency**: Offload resource-intensive tasks to cloud infrastructure
 
-# Direct Tool Calls (Without LLM)
+---
+
+# 🔌 MCP Client
+
+The **MCP Client** allows you to connect directly to MCP servers and call tools programmatically without an AI agent. This is useful when you know exactly which tools to call and don't need AI reasoning.
+
+## Direct Tool Calls (Without LLM)
 
 You can call MCP server tools directly without an LLM when you need programmatic control:
 
@@ -705,6 +721,23 @@ if __name__ == "__main__":
 
 ```
 
+---
+
+# 🛠️ MCP Server
+
+**Coming Soon!** Python support for creating MCP servers is under development.
+
+In the meantime, you can create MCP servers using our [TypeScript implementation](../typescript/README.md#%EF%B8%8F-mcp-server-framework), which offers:
+
+- Complete server framework with tools, resources, and prompts
+- Built-in inspector for debugging
+- React-based UI widgets for interactive experiences
+- Hot reload development workflow
+
+Python agents and clients can connect to TypeScript servers seamlessly - the MCP protocol is language-agnostic.
+
+---
+
 # Debugging
 
 MCP-Use provides a built-in debug mode that increases log verbosity and helps diagnose issues in your agent implementation.
@@ -768,14 +801,6 @@ This is useful when you only need to see the agent's steps and decision-making p
 
 We love contributions! Feel free to open issues for bugs or feature requests. Look at [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
-## Contributors
-
-Thanks to all our amazing contributors!
-
-<a href="https://github.com/mcp-use/mcp-use/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=mcp-use/mcp-use" />
-</a>
-
 ## Top Starred Dependents
 
 <!-- gh-dependents-info-used-by-start -->
@@ -787,23 +812,23 @@ Thanks to all our amazing contributors!
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/38653995?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/patchy631/ai-engineering-hub"><strong>patchy631/ai-engineering-hub</strong></a></td>
-    <td>⭐ 17917</td>
+    <td>⭐ 18021</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/164294848?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/buildfastwithai/gen-ai-experiments"><strong>buildfastwithai/gen-ai-experiments</strong></a></td>
-    <td>⭐ 178</td>
+    <td>⭐ 202</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/187057607?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/hud-evals/hud-python"><strong>hud-evals/hud-python</strong></a></td>
-    <td>⭐ 159</td>
+    <td>⭐ 168</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/170207473?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/tavily-ai/meeting-prep-agent"><strong>tavily-ai/meeting-prep-agent</strong></a></td>
-    <td>⭐ 136</td>
+    <td>⭐ 138</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/20041231?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/krishnaik06/MCP-CRASH-Course"><strong>krishnaik06/MCP-CRASH-Course</strong></a></td>
-    <td>⭐ 72</td>
+    <td>⭐ 74</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/54944174?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/larksuite/lark-samples"><strong>larksuite/lark-samples</strong></a></td>

{mcp_use-1.3.11 → mcp_use-1.3.13}/examples/chat_example.py

@@ -20,13 +20,11 @@ async def run_memory_chat():
     # Load environment variables for API keys
     load_dotenv()
 
-    # Config file path - change this to your config file
-    config_file = "examples/browser_mcp.json"
-
-    print("Initializing chat...")
-
-    # Create MCP client and agent with memory enabled
-    client = MCPClient.from_config_file(config_file)
+    config = {
+        "mcpServers": {"playwright": {"command": "npx", "args": ["@playwright/mcp@latest"], "env": {"DISPLAY": ":1"}}}
+    }
+    # Create MCPClient from config file
+    client = MCPClient(config=config)
     llm = ChatOpenAI(model="gpt-4o-mini")
 
     # Create agent with memory_enabled=True

mcp_use-1.3.13/examples/example_middleware.py

@@ -0,0 +1,72 @@
+"""
+Simple middleware example.
+
+This example demonstrates:
+1. How to use mcp_use with MCPClient and MCPAgent
+2. Default logging middleware (uses logger.debug)
+3. Optional custom middleware for specific use cases
+
+Special thanks to https://github.com/microsoft/playwright-mcp for the server.
+"""
+
+import asyncio
+import time
+from typing import Any
+
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+
+from mcp_use import MCPAgent, MCPClient
+from mcp_use.middleware import Middleware, MiddlewareContext, NextFunctionT
+
+
+async def main():
+    """Run the example with default logging and optional custom middleware."""
+    # Load environment variables
+    load_dotenv()
+
+    # Create custom middleware
+    class TimingMiddleware(Middleware):
+        async def on_request(self, context: MiddlewareContext[Any], call_next: NextFunctionT) -> Any:
+            start = time.time()
+            try:
+                print("--------------------------------")
+                print(f"{context.method} started")
+                print("--------------------------------")
+                print(f"{context.params}, {context.metadata}, {context.timestamp}, {context.connection_id}")
+                print("--------------------------------")
+                result = await call_next(context)
+                return result
+            finally:
+                duration = time.time() - start
+                print("--------------------------------")
+                print(f"{context.method} took {int(1000 * duration)}ms")
+                print("--------------------------------")
+
+    config = {
+        "mcpServers": {"playwright": {"command": "npx", "args": ["@playwright/mcp@latest"], "env": {"DISPLAY": ":1"}}}
+    }
+
+    # MCPClient includes default logging middleware automatically
+    # Add custom middleware only if needed
+    client = MCPClient(config=config, middleware=[TimingMiddleware()])
+
+    # Create LLM
+    llm = ChatOpenAI(model="gpt-4o")
+
+    # Create agent with the client
+    agent = MCPAgent(llm=llm, client=client, max_steps=30)
+
+    # Run the query
+    result = await agent.run(
+        """
+        Navigate to https://github.com/mcp-use/mcp-use and write
+        a summary of the project.
+        """,
+        max_steps=30,
+    )
+    print(f"\nResult: {result}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

mcp_use-1.3.13/examples/limited_memory_chat.py

@@ -0,0 +1,88 @@
+"""
+Simple chat example using MCPAgent with limited conversation memory.
+
+This example demonstrates how to use the MCPAgent with limited
+conversation history for better contextual interactions while
+keeping memory usage controlled.
+
+Special thanks to https://github.com/microsoft/playwright-mcp for the server.
+"""
+
+import asyncio
+
+from dotenv import load_dotenv
+from langchain_core.messages import AIMessage, HumanMessage
+from langchain_openai import ChatOpenAI
+
+from mcp_use import MCPAgent, MCPClient
+
+
+async def run_limited_memory_chat():
+    """Run a chat using MCPAgent with limited conversation memory."""
+    # Load environment variables for API keys
+    load_dotenv()
+
+    config = {
+        "mcpServers": {"playwright": {"command": "npx", "args": ["@playwright/mcp@latest"], "env": {"DISPLAY": ":1"}}}
+    }
+    # Create MCPClient from config file
+    client = MCPClient(config=config)
+    llm = ChatOpenAI(model="gpt-4o-mini")
+    # Create agent with memory_enabled=False but pass external history
+    agent = MCPAgent(
+        llm=llm,
+        client=client,
+        max_steps=15,
+        memory_enabled=True,  # Disable built-in memory, use external history
+    )
+
+    # Configuration: Limited history mode
+    MAX_HISTORY_MESSAGES = 5
+
+    print("\n===== Interactive MCP Chat (Limited Memory) =====")
+    print("Type 'exit' or 'quit' to end the conversation")
+    print("Type 'clear' to clear conversation history")
+    print("==================================\n")
+
+    try:
+        # Main chat loop with limited history
+        external_history = []
+
+        while True:
+            # Get user input
+            user_input = input("\nYou: ")
+
+            # Check for exit command
+            if user_input.lower() in ["exit", "quit"]:
+                print("Ending conversation...")
+                break
+
+            # Check for clear history command
+            if user_input.lower() == "clear":
+                external_history = []
+                print("Conversation history cleared.")
+                continue
+
+            # Get response from agent
+            try:
+                # Limit history to last N messages
+                limited_history = external_history[-MAX_HISTORY_MESSAGES:] if external_history else []
+                # Run the agent with the user input and limited history
+                print("\nAssistant: ", end="", flush=True)
+                response = await agent.run(user_input, external_history=limited_history)
+                print(response)
+                # Add to external history
+                external_history.append(HumanMessage(content=user_input))
+                external_history.append(AIMessage(content=response))
+
+            except Exception as e:
+                print(f"\nError: {e}")
+
+    finally:
+        # Clean up
+        if client and client.sessions:
+            await client.close_all_sessions()
+
+
+if __name__ == "__main__":
+    asyncio.run(run_limited_memory_chat())

{mcp_use-1.3.11 → mcp_use-1.3.13}/mcp_use/__init__.py

@@ -12,7 +12,7 @@ from importlib.metadata import version
 from .logging import MCP_USE_DEBUG, Logger, logger  # isort: skip
 
 # Now import other modules - observability must come after logging
-from . import observability  # noqa: E402
+from .agents import observability  # noqa: E402
 from .agents.mcpagent import MCPAgent
 from .client import MCPClient
 from .config import load_config_file

mcp_use-1.3.13/mcp_use/adapters/__init__.py

@@ -0,0 +1,21 @@
+# mcp_use/adapters/__init__.py
+import warnings
+
+from typing_extensions import deprecated
+
+from mcp_use.agents.adapters import BaseAdapter as _BaseAdapter
+from mcp_use.agents.adapters import LangChainAdapter as _LangChainAdapter
+
+warnings.warn(
+    "mcp_use.adapters is deprecated. Use mcp_use.agents.adapters. This import will be removed in version 1.4.0",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+
+@deprecated("Use mcp_use.agents.adapters.BaseAdapter")
+class BaseAdapter(_BaseAdapter): ...
+
+
+@deprecated("Use mcp_use.agents.adapters.LangChainAdapter")
+class LangChainAdapter(_LangChainAdapter): ...

mcp_use-1.3.13/mcp_use/adapters/base.py

@@ -0,0 +1,17 @@
+# mcp_use/adapters/base.py
+import warnings
+
+from typing_extensions import deprecated
+
+from mcp_use.agents.adapters.base import BaseAdapter as _BaseAdapter
+
+warnings.warn(
+    "mcp_use.adapters.base is deprecated. Use mcp_use.agents.adapters.base. "
+    "This import will be removed in version 1.4.0",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+
+@deprecated("Use mcp_use.agents.adapters.base.BaseAdapter")
+class BaseAdapter(_BaseAdapter): ...