PyPI - mcp-use - Versions diffs - 1.3.9__tar.gz → 1.3.11__tar.gz - Mend

mcp-use 1.3.9tar.gz → 1.3.11tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of mcp-use might be problematic. Click here for more details.

Files changed (191) hide show

{mcp_use-1.3.9 → mcp_use-1.3.11}/.github/workflows/tests.yml RENAMED Viewed

@@ -77,7 +77,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        primitive: [sampling, tools, resources, prompts, elicitation, notifications]
+        primitive: [sampling, tools, resources, prompts, elicitation, notifications, auth]
     steps:
       - uses: actions/checkout@v3
       - name: Set up Python 3.11

{mcp_use-1.3.9 → mcp_use-1.3.11}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-use
-Version: 1.3.9
+Version: 1.3.11
 Summary: MCP Library for LLMs
 Author-email: Pietro Zullo <pietro.zullo@gmail.com>
 License: MIT
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 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: mcp>=1.10.0
@@ -22,7 +23,7 @@ Requires-Dist: posthog>=4.8.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: scarf-sdk>=0.1.0
-Requires-Dist: websockets>=12.0
+Requires-Dist: websockets>=15.0
 Provides-Extra: anthropic
 Requires-Dist: langchain-anthropic; extra == 'anthropic'
 Provides-Extra: dev
@@ -52,13 +53,8 @@ Description-Content-Type: text/markdown
   </picture>
 </div>
-<br>
-# Create MCP Clients and Agents
-<p align="center">
-<a href="https://www.producthunt.com/products/mcp-use?embed=true&utm_source=badge-featured&utm_medium=badge&utm_source=badge-mcp&#0045;use" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1002629&theme=neutral&t=1754609432704" alt="mcp&#0045;use - Open&#0032;source&#0032;SDK&#0032;and&#0032;infra&#0032;for&#0032;MCP&#0032;servers&#0032;&#0038;&#0032;agents | Product Hunt" style="width: 150px; height: 32px;" width="150" height="32" /></a>
-</p>
+<h1 align="center">🚀 Create MCP Clients and Agents</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>
@@ -95,7 +91,7 @@ Description-Content-Type: text/markdown
 | 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) |
+| **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)                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 ## Features
@@ -154,7 +150,7 @@ pip install mcp-use
 Or install from source:
 ```bash
-git clone https://github.com/pietrozullo/mcp-use.git
+git clone https://github.com/mcp-use/mcp-use.git
 cd mcp-use
 pip install -e .
 ```
@@ -253,14 +249,14 @@ For other settings, models, and more, check out the documentation.
 ## Streaming Agent Output
-MCP-Use supports asynchronous streaming of agent output using the `astream` method on `MCPAgent`. This allows you to receive incremental results, tool actions, and intermediate steps as they are generated by the agent, enabling real-time feedback and progress reporting.
+MCP-Use supports asynchronous streaming of agent output using the `stream` method on `MCPAgent`. This allows you to receive incremental results, tool actions, and intermediate steps as they are generated by the agent, enabling real-time feedback and progress reporting.
 ### How to use
-Call `agent.astream(query)` and iterate over the results asynchronously:
+Call `agent.stream(query)` and iterate over the results asynchronously:
 ```python
-async for chunk in agent.astream("Find the best restaurant in San Francisco"):
+async for chunk in agent.stream("Find the best restaurant in San Francisco"):
     print(chunk["messages"], end="", flush=True)
 ```
@@ -280,7 +276,7 @@ async def main():
     client = MCPClient.from_config_file("browser_mcp.json")
     llm = ChatOpenAI(model="gpt-4o")
     agent = MCPAgent(llm=llm, client=client, max_steps=30)
-    async for chunk in agent.astream("Look for job at nvidia for machine learning engineer."):
+    async for chunk in agent.stream("Look for job at nvidia for machine learning engineer."):
         print(chunk["messages"], end="", flush=True)
 if __name__ == "__main__":
@@ -837,31 +833,31 @@ 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>⭐ 15920</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>⭐ 129</td>
+    <td>⭐ 17917</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>⭐ 93</td>
+    <td>⭐ 178</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>⭐ 76</td>
+    <td>⭐ 159</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>
   </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>⭐ 61</td>
+    <td>⭐ 72</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>
-    <td>⭐ 35</td>
+    <td>⭐ 40</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/892404?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/truemagic-coder/solana-agent-app"><strong>truemagic-coder/solana-agent-app</strong></a></td>
-    <td>⭐ 30</td>
+    <td>⭐ 29</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/8344498?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/schogini/techietalksai"><strong>schogini/techietalksai</strong></a></td>
@@ -869,11 +865,11 @@ Thanks to all our amazing contributors!
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/201161342?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/autometa-dev/whatsapp-mcp-voice-agent"><strong>autometa-dev/whatsapp-mcp-voice-agent</strong></a></td>
-    <td>⭐ 22</td>
+    <td>⭐ 23</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/100749943?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/Deniscartin/mcp-cli"><strong>Deniscartin/mcp-cli</strong></a></td>
-    <td>⭐ 19</td>
+    <td>⭐ 20</td>
   </tr>
 </table>

{mcp_use-1.3.9 → mcp_use-1.3.11}/README.md RENAMED Viewed

@@ -7,13 +7,8 @@
   </picture>
 </div>
-<br>
-# Create MCP Clients and Agents
-<p align="center">
-<a href="https://www.producthunt.com/products/mcp-use?embed=true&utm_source=badge-featured&utm_medium=badge&utm_source=badge-mcp&#0045;use" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1002629&theme=neutral&t=1754609432704" alt="mcp&#0045;use - Open&#0032;source&#0032;SDK&#0032;and&#0032;infra&#0032;for&#0032;MCP&#0032;servers&#0032;&#0038;&#0032;agents | Product Hunt" style="width: 150px; height: 32px;" width="150" height="32" /></a>
-</p>
+<h1 align="center">🚀 Create MCP Clients and Agents</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>
@@ -50,7 +45,7 @@
 | 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) |
+| **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)                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 ## Features
@@ -109,7 +104,7 @@ pip install mcp-use
 Or install from source:
 ```bash
-git clone https://github.com/pietrozullo/mcp-use.git
+git clone https://github.com/mcp-use/mcp-use.git
 cd mcp-use
 pip install -e .
 ```
@@ -208,14 +203,14 @@ For other settings, models, and more, check out the documentation.
 ## Streaming Agent Output
-MCP-Use supports asynchronous streaming of agent output using the `astream` method on `MCPAgent`. This allows you to receive incremental results, tool actions, and intermediate steps as they are generated by the agent, enabling real-time feedback and progress reporting.
+MCP-Use supports asynchronous streaming of agent output using the `stream` method on `MCPAgent`. This allows you to receive incremental results, tool actions, and intermediate steps as they are generated by the agent, enabling real-time feedback and progress reporting.
 ### How to use
-Call `agent.astream(query)` and iterate over the results asynchronously:
+Call `agent.stream(query)` and iterate over the results asynchronously:
 ```python
-async for chunk in agent.astream("Find the best restaurant in San Francisco"):
+async for chunk in agent.stream("Find the best restaurant in San Francisco"):
     print(chunk["messages"], end="", flush=True)
 ```
@@ -235,7 +230,7 @@ async def main():
     client = MCPClient.from_config_file("browser_mcp.json")
     llm = ChatOpenAI(model="gpt-4o")
     agent = MCPAgent(llm=llm, client=client, max_steps=30)
-    async for chunk in agent.astream("Look for job at nvidia for machine learning engineer."):
+    async for chunk in agent.stream("Look for job at nvidia for machine learning engineer."):
         print(chunk["messages"], end="", flush=True)
 if __name__ == "__main__":
@@ -792,31 +787,31 @@ 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>⭐ 15920</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>⭐ 129</td>
+    <td>⭐ 17917</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>⭐ 93</td>
+    <td>⭐ 178</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>⭐ 76</td>
+    <td>⭐ 159</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>
   </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>⭐ 61</td>
+    <td>⭐ 72</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>
-    <td>⭐ 35</td>
+    <td>⭐ 40</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/892404?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/truemagic-coder/solana-agent-app"><strong>truemagic-coder/solana-agent-app</strong></a></td>
-    <td>⭐ 30</td>
+    <td>⭐ 29</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/8344498?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/schogini/techietalksai"><strong>schogini/techietalksai</strong></a></td>
@@ -824,11 +819,11 @@ Thanks to all our amazing contributors!
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/201161342?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/autometa-dev/whatsapp-mcp-voice-agent"><strong>autometa-dev/whatsapp-mcp-voice-agent</strong></a></td>
-    <td>⭐ 22</td>
+    <td>⭐ 23</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/100749943?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/Deniscartin/mcp-cli"><strong>Deniscartin/mcp-cli</strong></a></td>
-    <td>⭐ 19</td>
+    <td>⭐ 20</td>
   </tr>
 </table>

mcp_use-1.3.11/docs/agent/interactive-chat-patterns.mdx ADDED Viewed

@@ -0,0 +1,272 @@
+---
+title: "Interactive Chat Patterns"
+description: "Create interactive chat interfaces with persistent conversation memory"
+icon: "message-circle"
+---
+## Building a chat loop
+With mcp-use you can build interactive interface where users can have conversations with
+your `MCPAgent`, maintaining context and memory across multiple queries.
+## Basic chat loop
+Here's a basic chat-loop with conversation memory enabled:
+```python chat_loop.py
+import asyncio
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+from mcp_use import MCPAgent, MCPClient
+async def basic_chat_loop():
+    """Simple console chat loop with MCPAgent"""
+    # Load environment variables
+    load_dotenv()
+    # MCP server configuration
+    config = {
+        "mcpServers": {
+            "playwright": {
+                "command": "npx",
+                "args": ["@playwright/mcp@latest"],
+                "env": {"DISPLAY": ":1"}
+            },
+            "filesystem": {
+                "command": "npx",
+                "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
+            }
+        }
+    }
+    # Create client and agent
+    client = MCPClient.from_dict(config)
+    llm = ChatOpenAI(model="gpt-4o")
+    agent = MCPAgent(llm=llm,
+        client=client,
+        memory_enabled=True, # Enable memory to track conversation history
+        max_steps=20)
+    # Some initial messages
+    print("🤖 MCP Agent Chat")
+    print("Type 'quit/exit' to exit the chat.")
+    print("Type 'clear' to clear conversation history")
+    try:
+        while True:
+            user_input = input("\nYou: ")
+            if user_input.lower() in ['quit', 'exit']:
+                print("👋 Goodbye!")
+                break
+            if user_input.lower() == 'clear':
+                agent.clear_conversation_history()
+                print("🧹 Conversation history cleared.")
+                continue
+            # Skip empty messages
+            if not user_input:
+                continue
+            try:
+                print("\n🤖 Assistant: ", end="", flush=True)
+                response = await agent.run(user_input)
+                print(response)
+            except KeyboardInterrupt: # Handle keyboard interrupt
+                print("\n\n⏸️ Interrupted by user")
+                break
+            except Exception as e:
+                print(f"\n❌ Error: {e}")
+                print("Please try again or type 'exit' to quit.")
+    finally:
+        await client.close_all_sessions()
+if __name__ == "__main__":
+    asyncio.run(basic_chat_loop())
+```
+## Streaming Chat Loop
+Here's a chat loop with streaming responses enabled:
+```python chat_loop_streaming.py
+import asyncio
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+from mcp_use import MCPAgent, MCPClient
+async def streaming_chat_loop():
+    """Chat loop with streaming responses with MCPAgent"""
+    # Load environment variables
+    load_dotenv()
+    # MCP server configuration
+    config = {
+        "mcpServers": {
+            "playwright": {
+                "command": "npx",
+                "args": ["@playwright/mcp@latest"],
+                "env": {"DISPLAY": ":1"}
+            }
+        }
+    }
+    # Create client and agent
+    client = MCPClient.from_dict(config)
+    llm = ChatOpenAI(model="gpt-4o")
+    agent = MCPAgent(llm=llm,
+        client=client,
+        memory_enabled=True, # Enable memory to track conversation history
+        max_steps=20)
+    # Some initial messages
+    print("🤖 MCP Agent Chat (Streaming)")
+    print("Type 'quit/exit' to exit the chat.")
+    print("Type 'clear' to clear conversation history")
+    try:
+        while True:
+            user_input = input("\nYou: ")
+            if user_input.lower() in ['quit', 'exit']:
+                print("👋 Goodbye!")
+                break
+            if user_input.lower() == 'clear':
+                agent.clear_conversation_history()
+                print("🧹 Conversation history cleared.")
+                continue
+            if not user_input: # Skip empty messages
+                continue
+            try:
+                print("\n🤖 Assistant: ", end="", flush=True)
+                # Stream the response
+                async for chunk in agent.stream(user_input):
+                    print(chunk, end="", flush=True)
+                print()
+            except KeyboardInterrupt: # Handle keyboard interrupt
+                print("\n\n⏸️ Interrupted by user")
+                break
+            except Exception as e:
+                print(f"\n❌ Error: {e}")
+                print("Please try again or type 'exit' to quit.")
+    finally:
+        await client.close_all_sessions()
+if __name__ == "__main__":
+    asyncio.run(streaming_chat_loop())
+```
+## Chat Loop with Structured I/O
+It's possible to create a chat loop that can handle both natural language and structured inputs, allowing users to request specific tasks or analyses in a structured format. Here's an example of how to implement this:
+```python
+import asyncio
+from dotenv import load_dotenv
+from pydantic import BaseModel, Field
+from langchain_openai import ChatOpenAI
+from mcp_use import MCPAgent, MCPClient
+from typing import Optional
+class TaskRequest(BaseModel):
+    task_type: Optional[str] = Field(description="The type of task to perform")
+    description: Optional[str] = Field(description="Detailed description of the task")
+    priority: Optional[str] = Field(description="Priority level: low, medium, high")
+async def structured_chat_loop():
+    """Chat loop that can handle both natural language and structured inputs."""
+    # Load environment variables
+    load_dotenv()
+    # MCP server configuration
+    config = {
+        "mcpServers": {
+            "playwright": {
+                "command": "npx",
+                "args": ["@playwright/mcp@latest"],
+                "env": {"DISPLAY": ":1"}
+            }
+        }
+    }
+    # Create client and agent
+    client = MCPClient.from_dict(config)
+    llm = ChatOpenAI(model="gpt-4o")
+    agent = MCPAgent(
+        llm=llm,
+        client=client,
+        memory_enabled=True, # Enable memory to track conversation history
+        max_steps=20
+    )
+    # Initial messages
+    print("🤖 MCP Agent Chat (Structured)")
+    print("You can chat naturally or request structured task analysis")
+    print("Type 'task' to create a structured task request")
+    try:
+        while True:
+            user_input = input("\nYou: ")
+            if user_input.lower() in ['exit', 'quit']:
+                print("👋 Goodbye!")
+                break
+            try:
+                if user_input.lower() == 'task':
+                    print("\n📋 Creating structured task...")
+                    task_description = input("Describe your task: ")
+                    task: TaskRequest = await agent.run(
+                        f"Analyze a task with the following description: {task_description}",
+                        output_schema=TaskRequest
+                    )
+                    # Print task analysis
+                    print(f"\n✅ Task Analysis:")
+                    print(f"• Type: {task.task_type}")
+                    print(f"• Description: {task.description}")
+                    print(f"• Priority: {task.priority or 'low'}")
+                    proceed = input("\nDo you want to proceed with this task? (y/n)")
+                    if proceed.lower() == 'y':
+                        response = await agent.run(
+                            f"Execute the following task: {task.description}"
+                        )
+                        print(f"\n🤖 Assistant: {response}")
+                else:
+                    # Regular conversation
+                    response = await agent.run(user_input)
+                    print(f"\n🤖 Assistant: {response}")
+            except KeyboardInterrupt:
+                print("\n👋 Goodbye!")
+                break
+            except Exception as e:
+                print(f"❌ Error: {e}")
+                print("Please try again or type 'exit' to quit.")
+    finally:
+        await client.close_all_sessions()
+if __name__ == "__main__":
+    asyncio.run(structured_chat_loop())
+```
+## Next Steps
+<CardGroup cols={3}>
+  <Card title="Agent Configuration" icon="cloud" href="/agent/agent-configuration">
+    Learn more about configuring agents for optimal streaming performance
+  </Card>
+  <Card title="Multi-Server Setup" icon="server" href="/advanced/multi-server-setup">
+    Stream output from agents using multiple MCP servers
+  </Card>
+  <Card title="Security Best Practices" icon="shield" href="/advanced/security">
+    Learn how to secure your MCP deployments
+  </Card>
+</CardGroup>

{mcp_use-1.3.9 → mcp_use-1.3.11}/docs/agent/server-manager.mdx RENAMED Viewed

@@ -71,6 +71,7 @@ agent = MCPAgent(
 )
 ```
 ## 🔍 Tool Discovery Flow
@@ -213,3 +214,54 @@ if __name__ == "__main__":
 ```
 The Server Manager transforms your MCP agent from a static tool user into an intelligent, adaptive assistant that can dynamically discover and utilize the perfect tools for any task! 🚀
+## Bring Your Own Server Manager
+For ultimate control, you can create your own server manager. By implementing the `BaseServerManager` abstract class, you can define custom logic for tool discovery, dynamic tool creation, or integration with other systems. The server manager's primary role is to provide tools **to the agent**. These can be management tools for connecting to external MCP servers, or, as shown below, custom tools that operate entirely within the agent's environment without needing an external server.
+Here’s a minimal example of a custom server manager that provides a single, hard-coded tool directly to the agent.
+```python
+import asyncio
+from mcp_use.agents import MCPAgent
+from mcp_use.managers.base import BaseServerManager
+from langchain_core.tools import BaseTool
+from langchain_openai import ChatOpenAI
+from pydantic import BaseModel
+# 1. Define a custom tool
+class HelloWorldTool(BaseTool):
+    """A simple tool that returns a greeting."""
+    name: str = "hello_world"
+    description: str = "Returns 'Hello, World!'"
+    args_schema: type[BaseModel] | None = None
+    def _run(self) -> str: return "Hello, World!"
+    async def _arun(self) -> str: return "Hello, World!"
+# 2. Implement the BaseServerManager interface
+class SimpleServerManager(BaseServerManager):
+    """A minimal server manager with one tool."""
+    def __init__(self):
+        self._tools = [HelloWorldTool()]
+    async def initialize(self) -> None: pass
+    @property
+    def tools(self) -> list[BaseTool]: return self._tools
+    def has_tool_changes(self, current_tool_names: set[str]) -> bool:
+        return {tool.name for tool in self.tools} != current_tool_names
+# 3. Pass your custom manager to the agent
+async def useCustomManager():
+    agent = MCPAgent(
+        llm=ChatOpenAI(model="gpt-4o"),
+        use_server_manager=True,
+        server_manager=SimpleServerManager(),
+    )
+    # The agent now has access to your custom tool
+    result = await agent.run("Use the hello_world tool")
+    print(result) #> "Hello, World!"
+    await agent.close()
+asyncio.run(useCustomManager())
+```

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

Potentially problematic release.

mcp-use 1.3.9tar.gz → 1.3.11tar.gz