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

{mcp_use-1.3.9 → mcp_use-1.3.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-use
-Version: 1.3.9
+Version: 1.3.10
 Summary: MCP Library for LLMs
 Author-email: Pietro Zullo <pietro.zullo@gmail.com>
 License: MIT
@@ -52,13 +52,14 @@ Description-Content-Type: text/markdown
   </picture>
 </div>
 
-<br>
-
-# Create MCP Clients and Agents
+<div align="center">
+  <h2>🎉 <strong>We're LIVE on Product Hunt!</strong> 🎉</h2>
+  <p><strong>Support us today and help us reach #1!</strong></p>
+  <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: 220px; height: 54px;" width="250" height="54" /></a>
+  <p>👆 <em>Click to upvote and leave a comment!</em></p>
+</div>
 
-<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>
@@ -154,7 +155,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 .
 ```
@@ -837,23 +838,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>⭐ 15920</td>
+    <td>⭐ 17384</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>⭐ 131</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>⭐ 100</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>⭐ 78</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>⭐ 64</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>
@@ -869,7 +870,7 @@ 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>

{mcp_use-1.3.9 → mcp_use-1.3.10}/README.md

@@ -7,13 +7,14 @@
   </picture>
 </div>
 
-<br>
-
-# Create MCP Clients and Agents
+<div align="center">
+  <h2>🎉 <strong>We're LIVE on Product Hunt!</strong> 🎉</h2>
+  <p><strong>Support us today and help us reach #1!</strong></p>
+  <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: 220px; height: 54px;" width="250" height="54" /></a>
+  <p>👆 <em>Click to upvote and leave a comment!</em></p>
+</div>
 
-<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>
@@ -109,7 +110,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 .
 ```
@@ -792,23 +793,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>⭐ 15920</td>
+    <td>⭐ 17384</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>⭐ 131</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>⭐ 100</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>⭐ 78</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>⭐ 64</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>
@@ -824,7 +825,7 @@ 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>

mcp_use-1.3.10/docs/agent/interactive-chat-patterns.mdx

@@ -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.10}/docs/agent/server-manager.mdx

@@ -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 → mcp_use-1.3.10}/docs/docs.json

@@ -89,7 +89,8 @@
               "agent/llm-integration",
               "agent/server-manager",
               "agent/streaming",
-              "agent/structured-output"
+              "agent/structured-output",
+              "agent/interactive-chat-patterns"
             ]
           },
           {

mcp_use-1.3.10/examples/simple_server_manager_use.py

@@ -0,0 +1,112 @@
+import asyncio
+import sys
+from pathlib import Path
+
+from langchain_core.tools import BaseTool
+from langchain_openai import ChatOpenAI
+from pydantic import BaseModel
+
+from mcp_use.agents.mcpagent import MCPAgent
+
+# Add the project root to the Python path
+sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
+from mcp_use.managers.base import BaseServerManager
+
+
+class DynamicTool(BaseTool):
+    """A tool that is created dynamically."""
+
+    name: str
+    description: str
+    args_schema: type[BaseModel] | None = None
+
+    def _run(self) -> str:
+        return f"Hello from {self.name}!"
+
+    async def _arun(self) -> str:
+        return f"Hello from {self.name}!"
+
+
+class HelloWorldTool(BaseTool):
+    """A simple tool that returns a greeting and adds a new tool."""
+
+    name: str = "hello_world"
+    description: str = "Returns the string 'Hello, World!' and adds a new dynamic tool."
+    args_schema: type[BaseModel] | None = None
+    server_manager: "SimpleServerManager"
+
+    def _run(self) -> str:
+        new_tool = DynamicTool(
+            name=f"dynamic_tool_{len(self.server_manager.tools)}", description="A dynamically created tool."
+        )
+        self.server_manager.add_tool(new_tool)
+        return "Hello, World! I've added a new tool. You can use it now."
+
+    async def _arun(self) -> str:
+        new_tool = DynamicTool(
+            name=f"dynamic_tool_{len(self.server_manager.tools)}", description="A dynamically created tool."
+        )
+        self.server_manager.add_tool(new_tool)
+        return "Hello, World! I've added a new tool. You can use it now."
+
+
+class SimpleServerManager(BaseServerManager):
+    """A simple server manager that provides a HelloWorldTool."""
+
+    def __init__(self):
+        self._tools: list[BaseTool] = []
+        self._initialized = False
+        # Pass a reference to the server manager to the tool
+        self._tools.append(HelloWorldTool(server_manager=self))
+
+    def add_tool(self, tool: BaseTool):
+        self._tools.append(tool)
+
+    async def initialize(self) -> None:
+        self._initialized = True
+
+    @property
+    def tools(self) -> list[BaseTool]:
+        return self._tools
+
+    def has_tool_changes(self, current_tool_names: set[str]) -> bool:
+        new_tool_names = {tool.name for tool in self.tools}
+        return new_tool_names != current_tool_names
+
+
+async def main():
+    # Initialize the LLM
+    llm = ChatOpenAI(model="gpt-4o")
+
+    # Instantiate the custom server manager
+    simple_server_manager = SimpleServerManager()
+
+    # Create an MCPAgent with the custom server manager
+    agent = MCPAgent(
+        llm=llm,
+        use_server_manager=True,
+        server_manager=simple_server_manager,
+    )
+
+    # Manually initialize the agent
+    await agent.initialize()
+
+    # Run the agent with a query that uses the custom tool
+    print("--- First run: calling hello_world ---")
+    result = await agent.run("Use the hello_world tool", manage_connector=False)
+    print(result)
+
+    # Clear the conversation history to avoid confusion
+    agent.clear_conversation_history()
+
+    # Run the agent again to show that the new tool is available
+    print("\n--- Second run: calling the new dynamic tool ---")
+    result = await agent.run("Use the dynamic_tool_1", manage_connector=False)
+    print(result)
+
+    # Manually close the agent
+    await agent.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

{mcp_use-1.3.9 → mcp_use-1.3.10}/mcp_use/__init__.py

@@ -7,12 +7,16 @@ to MCP tools through existing LangChain adapters.
 
 from importlib.metadata import version
 
-from . import observability
+# Import logging FIRST to ensure it's configured before other modules
+# This MUST happen before importing observability to ensure loggers are configured
+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.mcpagent import MCPAgent
 from .client import MCPClient
 from .config import load_config_file
 from .connectors import BaseConnector, HttpConnector, StdioConnector, WebSocketConnector
-from .logging import MCP_USE_DEBUG, Logger, logger
 from .session import MCPSession
 
 __version__ = version("mcp-use")