mcp-use 1.0.3__tar.gz → 1.1.5__tar.gz

mcp_use-1.1.5/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

{mcp_use-1.0.3 → mcp_use-1.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-use
-Version: 1.0.3
+Version: 1.1.5
 Summary: MCP Library for LLMs
 Author-email: Pietro Zullo <pietro.zullo@gmail.com>
 License: MIT
@@ -56,6 +56,19 @@ Description-Content-Type: text/markdown
 
 💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
 
+# Features
+
+## ✨ Key Features
+
+| Feature | Description |
+|---------|-------------|
+| 🔄 **Ease of use** | Create your first MCP capable agent you need only 6 lines of code |
+| 🤖 **LLM Flexibility** | Works with any langchain supported LLM that supports tool calling (OpenAI, Anthropic, Groq, LLama etc.) |
+| 🌐 **HTTP Support** | Direct connection to MCP servers running on specific HTTP ports |
+| 🧩 **Multi-Server Support** | Use multiple MCP servers simultaneously in a single agent |
+| 🛡️ **Tool Restrictions** | Restrict potentially dangerous tools like file system or network access |
+
+
 # Quick start
 
 With pip:
@@ -72,7 +85,30 @@ cd mcp-use
 pip install -e .
 ```
 
-Spin up your agent:
+### Installing LangChain Providers
+
+mcp_use works with various LLM providers through LangChain. You'll need to install the appropriate LangChain provider package for your chosen LLM. For example:
+
+```bash
+# For OpenAI
+pip install langchain-openai
+
+# For Anthropic
+pip install langchain-anthropic
+
+# For other providers, check the [LangChain chat models documentation](https://python.langchain.com/docs/integrations/chat/)
+```
+
+and add your API keys for the provider you want to use to your `.env` file.
+
+```bash
+OPENAI_API_KEY=
+ANTHROPIC_API_KEY=
+```
+
+> **Important**: Only models with tool calling capabilities can be used with mcp_use. Make sure your chosen model supports function calling or tool use.
+
+### Spin up your agent:
 
 ```python
 import asyncio
@@ -85,8 +121,21 @@ async def main():
     # Load environment variables
     load_dotenv()
 
-    # Create MCPClient from config file
-    client = MCPClient.from_config_file("browser_mcp.json")
+    # Create configuration dictionary
+    config = {
+      "mcpServers": {
+        "playwright": {
+          "command": "npx",
+          "args": ["@playwright/mcp@latest"],
+          "env": {
+            "DISPLAY": ":1"
+          }
+        }
+      }
+    }
+
+    # Create MCPClient from configuration dictionary
+    client = MCPClient.from_dict(config)
 
     # Create LLM
     llm = ChatOpenAI(model="gpt-4o")
@@ -96,7 +145,7 @@ async def main():
 
     # Run the query
     result = await agent.run(
-        "Find the best restaurant in San Francisco USING GOOGLE SEARCH",
+        "Find the best restaurant in San Francisco",
     )
     print(f"\nResult: {result}")
 
@@ -104,6 +153,14 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
+You can also add the servers configuration from a config file like this:
+
+```python
+client = MCPClient.from_config_file(
+        os.path.join("browser_mcp.json")
+    )
+```
+
 Example configuration file (`browser_mcp.json`):
 
 ```json
@@ -120,15 +177,9 @@ Example configuration file (`browser_mcp.json`):
 }
 ```
 
-Add your API keys for the provider you want to use to your `.env` file.
-
-```bash
-OPENAI_API_KEY=
-ANTHROPIC_API_KEY=
-```
-
 For other settings, models, and more, check out the documentation.
 
+
 # Example Use Cases
 
 ## Web Browsing with Playwright
@@ -286,6 +337,55 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
+## HTTP Connection Example
+
+MCP-Use now supports HTTP connections, allowing you to connect to MCP servers running on specific HTTP ports. This feature is particularly useful for integrating with web-based MCP servers.
+
+Here's an example of how to use the HTTP connection feature:
+
+```python
+import asyncio
+import os
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+from mcp_use import MCPAgent, MCPClient
+
+async def main():
+    """Run the example using a configuration file."""
+    # Load environment variables
+    load_dotenv()
+
+    config = {
+        "mcpServers": {
+            "http": {
+                "url": "http://localhost:8931/sse"
+            }
+        }
+    }
+
+    # Create MCPClient from config file
+    client = MCPClient.from_dict(config)
+
+    # 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(
+        "Find the best restaurant in San Francisco USING GOOGLE SEARCH",
+        max_steps=30,
+    )
+    print(f"\nResult: {result}")
+
+if __name__ == "__main__":
+    # Run the appropriate example
+    asyncio.run(main())
+```
+
+This example demonstrates how to connect to an MCP server running on a specific HTTP port. Make sure to start your MCP server before running this example.
+
 # Multi-Server Support
 
 MCP-Use supports working with multiple MCP servers simultaneously, allowing you to combine tools from different servers in a single agent. This is useful for complex tasks that require multiple capabilities, such as web browsing combined with file operations or 3D modeling.

{mcp_use-1.0.3 → mcp_use-1.1.5}/README.md

@@ -17,6 +17,19 @@
 
 💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
 
+# Features
+
+## ✨ Key Features
+
+| Feature | Description |
+|---------|-------------|
+| 🔄 **Ease of use** | Create your first MCP capable agent you need only 6 lines of code |
+| 🤖 **LLM Flexibility** | Works with any langchain supported LLM that supports tool calling (OpenAI, Anthropic, Groq, LLama etc.) |
+| 🌐 **HTTP Support** | Direct connection to MCP servers running on specific HTTP ports |
+| 🧩 **Multi-Server Support** | Use multiple MCP servers simultaneously in a single agent |
+| 🛡️ **Tool Restrictions** | Restrict potentially dangerous tools like file system or network access |
+
+
 # Quick start
 
 With pip:
@@ -33,7 +46,30 @@ cd mcp-use
 pip install -e .
 ```
 
-Spin up your agent:
+### Installing LangChain Providers
+
+mcp_use works with various LLM providers through LangChain. You'll need to install the appropriate LangChain provider package for your chosen LLM. For example:
+
+```bash
+# For OpenAI
+pip install langchain-openai
+
+# For Anthropic
+pip install langchain-anthropic
+
+# For other providers, check the [LangChain chat models documentation](https://python.langchain.com/docs/integrations/chat/)
+```
+
+and add your API keys for the provider you want to use to your `.env` file.
+
+```bash
+OPENAI_API_KEY=
+ANTHROPIC_API_KEY=
+```
+
+> **Important**: Only models with tool calling capabilities can be used with mcp_use. Make sure your chosen model supports function calling or tool use.
+
+### Spin up your agent:
 
 ```python
 import asyncio
@@ -46,8 +82,21 @@ async def main():
     # Load environment variables
     load_dotenv()
 
-    # Create MCPClient from config file
-    client = MCPClient.from_config_file("browser_mcp.json")
+    # Create configuration dictionary
+    config = {
+      "mcpServers": {
+        "playwright": {
+          "command": "npx",
+          "args": ["@playwright/mcp@latest"],
+          "env": {
+            "DISPLAY": ":1"
+          }
+        }
+      }
+    }
+
+    # Create MCPClient from configuration dictionary
+    client = MCPClient.from_dict(config)
 
     # Create LLM
     llm = ChatOpenAI(model="gpt-4o")
@@ -57,7 +106,7 @@ async def main():
 
     # Run the query
     result = await agent.run(
-        "Find the best restaurant in San Francisco USING GOOGLE SEARCH",
+        "Find the best restaurant in San Francisco",
     )
     print(f"\nResult: {result}")
 
@@ -65,6 +114,14 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
+You can also add the servers configuration from a config file like this:
+
+```python
+client = MCPClient.from_config_file(
+        os.path.join("browser_mcp.json")
+    )
+```
+
 Example configuration file (`browser_mcp.json`):
 
 ```json
@@ -81,15 +138,9 @@ Example configuration file (`browser_mcp.json`):
 }
 ```
 
-Add your API keys for the provider you want to use to your `.env` file.
-
-```bash
-OPENAI_API_KEY=
-ANTHROPIC_API_KEY=
-```
-
 For other settings, models, and more, check out the documentation.
 
+
 # Example Use Cases
 
 ## Web Browsing with Playwright
@@ -247,6 +298,55 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
+## HTTP Connection Example
+
+MCP-Use now supports HTTP connections, allowing you to connect to MCP servers running on specific HTTP ports. This feature is particularly useful for integrating with web-based MCP servers.
+
+Here's an example of how to use the HTTP connection feature:
+
+```python
+import asyncio
+import os
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+from mcp_use import MCPAgent, MCPClient
+
+async def main():
+    """Run the example using a configuration file."""
+    # Load environment variables
+    load_dotenv()
+
+    config = {
+        "mcpServers": {
+            "http": {
+                "url": "http://localhost:8931/sse"
+            }
+        }
+    }
+
+    # Create MCPClient from config file
+    client = MCPClient.from_dict(config)
+
+    # 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(
+        "Find the best restaurant in San Francisco USING GOOGLE SEARCH",
+        max_steps=30,
+    )
+    print(f"\nResult: {result}")
+
+if __name__ == "__main__":
+    # Run the appropriate example
+    asyncio.run(main())
+```
+
+This example demonstrates how to connect to an MCP server running on a specific HTTP port. Make sure to start your MCP server before running this example.
+
 # Multi-Server Support
 
 MCP-Use supports working with multiple MCP servers simultaneously, allowing you to combine tools from different servers in a single agent. This is useful for complex tasks that require multiple capabilities, such as web browsing combined with file operations or 3D modeling.

{mcp_use-1.0.3 → mcp_use-1.1.5}/docs/introduction.mdx

@@ -25,6 +25,9 @@ mcp_use is an open source library that enables developers to connect any Languag
   <Card title="Universal LLM Support" icon="robot" href="/essentials/llm-integration">
     Compatible with any LangChain-supported LLM provider
   </Card>
+  <Card title="HTTP Connection" icon="network" href="/quickstart">
+    Connect to MCP servers running on specific HTTP ports for web-based integrations
+  </Card>
 </CardGroup>
 
 ## Getting Started

mcp_use-1.1.5/docs/logo/dark.svg

@@ -0,0 +1,7 @@
+<svg width="303" height="303" viewBox="0 0 303 303" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M106.066 106.066C86.5398 125.592 54.8816 125.592 35.3554 106.066V106.066C15.8291 86.5397 15.8291 54.8815 35.3554 35.3552V35.3552C54.8816 15.829 86.5398 15.829 106.066 35.3552V35.3552C125.592 54.8815 125.592 86.5397 106.066 106.066V106.066Z" fill="white"/>
+<path d="M267.286 267.286C247.76 286.812 216.102 286.812 196.576 267.286V267.286C177.049 247.76 177.049 216.102 196.576 196.576V196.576C216.102 177.049 247.76 177.049 267.286 196.576V196.576C286.813 216.102 286.813 247.76 267.286 267.286V267.286Z" fill="white"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M181.957 230.04L211.425 259.508L260.922 210.011L232.851 181.94C204.215 181.726 175.645 170.695 153.796 148.846C131.947 126.997 120.915 98.4264 120.702 69.7903L92.631 41.7193L43.1335 91.2168L72.6014 120.685C100.313 121.56 127.765 132.573 148.917 153.725C170.069 174.877 181.082 202.328 181.957 230.04Z" fill="white"/>
+<circle cx="70.3209" cy="232.321" r="50" fill="white"/>
+<circle cx="232.321" cy="70.3209" r="50" fill="white"/>
+</svg>

mcp_use-1.1.5/docs/logo/light.svg

@@ -0,0 +1,7 @@
+<svg width="303" height="303" viewBox="0 0 303 303" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M106.066 106.066C86.5398 125.592 54.8816 125.592 35.3554 106.066V106.066C15.8291 86.5397 15.8291 54.8815 35.3554 35.3552V35.3552C54.8816 15.829 86.5398 15.829 106.066 35.3552V35.3552C125.592 54.8815 125.592 86.5397 106.066 106.066V106.066Z" fill="black"/>
+<path d="M267.286 267.286C247.76 286.812 216.102 286.812 196.576 267.286V267.286C177.049 247.76 177.049 216.102 196.576 196.576V196.576C216.102 177.049 247.76 177.049 267.286 196.576V196.576C286.813 216.102 286.813 247.76 267.286 267.286V267.286Z" fill="black"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M181.957 230.04L211.425 259.508L260.922 210.011L232.851 181.94C204.215 181.726 175.645 170.695 153.796 148.846C131.947 126.997 120.915 98.4264 120.702 69.7903L92.631 41.7193L43.1335 91.2168L72.6014 120.685C100.313 121.56 127.765 132.573 148.917 153.725C170.069 174.877 181.082 202.328 181.957 230.04Z" fill="black"/>
+<circle cx="70.3209" cy="232.321" r="50" fill="black"/>
+<circle cx="232.321" cy="70.3209" r="50" fill="black"/>
+</svg>

mcp_use-1.1.5/docs/quickstart.mdx

@@ -0,0 +1,234 @@
+---
+title: Quickstart
+description: "Get started with mcp_use in minutes"
+---
+
+# Quickstart Guide
+
+This guide will help you get started with mcp_use quickly. We'll cover installation, basic configuration, and running your first agent.
+
+## Installation
+
+You can install mcp_use using pip:
+
+```bash
+pip install mcp-use
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/pietrozullo/mcp-use.git
+cd mcp-use
+pip install -e .
+```
+
+## Installing LangChain Providers
+
+mcp_use works with various LLM providers through LangChain. You'll need to install the appropriate LangChain provider package for your chosen LLM. For example:
+
+```bash
+# For OpenAI
+pip install langchain-openai
+
+# For Anthropic
+pip install langchain-anthropic
+
+# For other providers, check the [LangChain chat models documentation](https://python.langchain.com/docs/integrations/chat/)
+```
+
+> **Important**: Only models with tool calling capabilities can be used with mcp_use. Make sure your chosen model supports function calling or tool use.
+
+## Environment Setup
+
+Set up your environment variables in a `.env` file:
+
+```bash
+OPENAI_API_KEY=your_api_key_here
+ANTHROPIC_API_KEY=your_api_key_here
+```
+
+## Your First Agent
+
+Here's a simple example to get you started:
+
+```python
+import asyncio
+import os
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+from mcp_use import MCPAgent, MCPClient
+
+async def main():
+    # Load environment variables
+    load_dotenv()
+
+    # Create configuration dictionary
+    config = {
+      "mcpServers": {
+        "playwright": {
+          "command": "npx",
+          "args": ["@playwright/mcp@latest"],
+          "env": {
+            "DISPLAY": ":1"
+          }
+        }
+      }
+    }
+
+    # Create MCPClient from configuration dictionary
+    client = MCPClient.from_dict(config)
+
+    # 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(
+        "Find the best restaurant in San Francisco USING GOOGLE SEARCH",
+    )
+    print(f"\nResult: {result}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Configuration Options
+
+You can also add the servers configuration from a config file:
+
+```python
+client = MCPClient.from_config_file(
+    os.path.join("browser_mcp.json")
+)
+```
+
+Example configuration file (`browser_mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["@playwright/mcp@latest"],
+      "env": {
+        "DISPLAY": ":1"
+      }
+    }
+  }
+}
+```
+
+## Restricting Tool Access
+
+You can control which tools are available to the agent:
+
+```python
+import asyncio
+import os
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+from mcp_use import MCPAgent, MCPClient
+
+async def main():
+    # Load environment variables
+    load_dotenv()
+
+    # Create configuration dictionary
+    config = {
+      "mcpServers": {
+        "playwright": {
+          "command": "npx",
+          "args": ["@playwright/mcp@latest"],
+          "env": {
+            "DISPLAY": ":1"
+          }
+        }
+      }
+    }
+
+    # Create MCPClient from configuration dictionary
+    client = MCPClient.from_dict(config)
+
+    # Create LLM
+    llm = ChatOpenAI(model="gpt-4o")
+
+    # Create agent with restricted tools
+    agent = MCPAgent(
+        llm=llm,
+        client=client,
+        max_steps=30,
+        disallowed_tools=["file_system", "network"]  # Restrict potentially dangerous tools
+    )
+
+    # Run the query
+    result = await agent.run(
+        "Find the best restaurant in San Francisco USING GOOGLE SEARCH",
+    )
+    print(f"\nResult: {result}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Available MCP Servers
+
+mcp_use supports any MCP server, allowing you to connect to a wide range of server implementations. For a comprehensive list of available servers, check out the [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) repository.
+
+
+Each server requires its own configuration. Check the [Configuration Guide](/essentials/configuration) for details.
+
+## HTTP Connection
+
+mcp_use now supports HTTP connections, allowing you to connect to MCP servers running on specific HTTP ports. This feature is particularly useful for integrating with web-based MCP servers.
+
+Here's a simple example to get you started with HTTP connections:
+
+```python
+import asyncio
+import os
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+from mcp_use import MCPAgent, MCPClient
+
+async def main():
+    # Load environment variables
+    load_dotenv()
+
+    # Create configuration dictionary
+    config = {
+      "mcpServers": {
+        "http": {
+          "url": "http://localhost:8931/sse"
+        }
+      }
+    }
+
+    # Create MCPClient from configuration dictionary
+    client = MCPClient.from_dict(config)
+
+    # 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(
+        "Find the best restaurant in San Francisco USING GOOGLE SEARCH",
+    )
+    print(f"\nResult: {result}")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+This example demonstrates how to connect to an MCP server running on a specific HTTP port. Make sure to start your MCP server before running this example.
+
+## Next Steps
+
+- Learn about [Configuration Options](/essentials/configuration)
+- Explore [Example Use Cases](/examples)
+- Check out [Advanced Features](/essentials/advanced)

mcp_use-1.1.5/examples/http_example.py

@@ -0,0 +1,53 @@
+"""
+HTTP Example for mcp_use.
+
+This example demonstrates how to use the mcp_use library with MCPClient
+to connect to an MCP server running on a specific HTTP port.
+
+Before running this example, you need to start the Playwright MCP server
+in another terminal with:
+
+    npx @playwright/mcp@latest --port 8931
+
+This will start the server on port 8931. Resulting in the config you find below.
+Of course you can run this with any server you want at any URL.
+
+Special thanks to https://github.com/microsoft/playwright-mcp for the server.
+
+"""
+
+import asyncio
+
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+
+from mcp_use import MCPAgent, MCPClient
+
+
+async def main():
+    """Run the example using a configuration file."""
+    # Load environment variables
+    load_dotenv()
+
+    config = {"mcpServers": {"http": {"url": "http://localhost:8931/sse"}}}
+
+    # Create MCPClient from config file
+    client = MCPClient.from_dict(config)
+
+    # 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(
+        "Find the best restaurant in San Francisco USING GOOGLE SEARCH",
+        max_steps=30,
+    )
+    print(f"\nResult: {result}")
+
+
+if __name__ == "__main__":
+    # Run the appropriate example
+    asyncio.run(main())

{mcp_use-1.0.3 → mcp_use-1.1.5}/mcp_use/agents/langchain_agent.py

@@ -112,7 +112,7 @@ class LangChainAgent:
         # Recreate the agent with the new system message if it exists
         if self.agent and self.tools:
             self.agent = self._create_agent()
-            logger.info("Agent recreated with new system message")
+            logger.debug("Agent recreated with new system message")
 
     async def initialize(self) -> None:
         """Initialize the agent and its tools."""
@@ -181,7 +181,7 @@ class LangChainAgent:
                         Raises:
                             ToolException: If tool execution fails.
                         """
-                        logger.info(f'MCP tool: "{self.name}" received input: {kwargs}')
+                        logger.debug(f'MCP tool: "{self.name}" received input: {kwargs}')
 
                         try:
                             tool_result: CallToolResult = await self.connector.call_tool(
@@ -207,7 +207,7 @@ class LangChainAgent:
                 tools.append(McpToLangChainAdapter())
 
         # Log available tools for debugging
-        logger.info(f"Available tools: {[tool.name for tool in tools]}")
+        logger.debug(f"Available tools: {[tool.name for tool in tools]}")
         return tools
 
     def _create_agent(self) -> AgentExecutor:

{mcp_use-1.0.3 → mcp_use-1.1.5}/mcp_use/agents/mcpagent.py

@@ -209,7 +209,7 @@ class MCPAgent:
         # If the agent is already initialized, we need to reinitialize it
         # to apply the changes to the available tools
         if self._initialized:
-            logger.info(
+            logger.debug(
                 "Agent already initialized. Changes will take effect on next initialization."
             )
             # We don't automatically reinitialize here as it could be disruptive
@@ -254,11 +254,11 @@ class MCPAgent:
         try:
             # Initialize if needed
             if manage_connector and (not self._initialized or not self._agent):
-                logger.info("Initializing agent before running query")
+                logger.debug("Initializing agent before running query")
                 await self.initialize()
                 initialized_here = True
             elif not self._initialized and self.auto_initialize:
-                logger.info("Auto-initializing agent before running query")
+                logger.debug("Auto-initializing agent before running query")
                 await self.initialize()
                 initialized_here = True
 
@@ -289,7 +289,7 @@ class MCPAgent:
                 # Other message types can be handled here if needed
 
             # Run the query with the specified max_steps or default
-            logger.info(f"Running query with max_steps={max_steps or self.max_steps}")
+            logger.debug(f"Running query with max_steps={max_steps or self.max_steps}")
             result = await self._agent.run(
                 query=query,
                 max_steps=max_steps,
@@ -307,7 +307,7 @@ class MCPAgent:
             # If we initialized in this method and there was an error,
             # make sure to clean up
             if initialized_here and manage_connector:
-                logger.info("Cleaning up resources after initialization error")
+                logger.debug("Cleaning up resources after initialization error")
                 await self.close()
             raise
 
@@ -315,7 +315,7 @@ class MCPAgent:
             # Clean up resources if we're managing the connector and
             # we're not using a client that manages sessions
             if manage_connector and not self.client and not initialized_here:
-                logger.info("Closing agent after query completion")
+                logger.debug("Closing agent after query completion")
                 await self.close()
 
     async def close(self) -> None:
@@ -338,7 +338,7 @@ class MCPAgent:
                     await connector.disconnect()
 
             self._initialized = False
-            logger.info("Agent closed successfully")
+            logger.debug("Agent closed successfully")
 
         except Exception as e:
             logger.error(f"Error during agent closure: {e}")

{mcp_use-1.0.3 → mcp_use-1.1.5}/mcp_use/client.py

@@ -214,7 +214,7 @@ class MCPClient:
 
         try:
             # Disconnect from the session
-            logger.info(f"Closing session for server '{server_name}'")
+            logger.debug(f"Closing session for server '{server_name}'")
             await session.disconnect()
         except Exception as e:
             logger.error(f"Error closing session for server '{server_name}': {e}")
@@ -237,7 +237,7 @@ class MCPClient:
 
         for server_name in server_names:
             try:
-                logger.info(f"Closing session for server '{server_name}'")
+                logger.debug(f"Closing session for server '{server_name}'")
                 await self.close_session(server_name)
             except Exception as e:
                 error_msg = f"Failed to close session for server '{server_name}': {e}"
@@ -248,4 +248,4 @@ class MCPClient:
         if errors:
             logger.error(f"Encountered {len(errors)} errors while closing sessions")
         else:
-            logger.info("All sessions closed successfully")
+            logger.debug("All sessions closed successfully")

{mcp_use-1.0.3 → mcp_use-1.1.5}/mcp_use/connectors/base.py

@@ -39,10 +39,10 @@ class BaseConnector(ABC):
             logger.debug("Not connected to MCP implementation")
             return
 
-        logger.info("Disconnecting from MCP implementation")
+        logger.debug("Disconnecting from MCP implementation")
         await self._cleanup_resources()
         self._connected = False
-        logger.info("Disconnected from MCP implementation")
+        logger.debug("Disconnected from MCP implementation")
 
     async def _cleanup_resources(self) -> None:
         """Clean up all resources associated with this connector."""
@@ -83,7 +83,7 @@ class BaseConnector(ABC):
         if not self.client:
             raise RuntimeError("MCP client is not connected")
 
-        logger.info("Initializing MCP session")
+        logger.debug("Initializing MCP session")
 
         # Initialize the session
         result = await self.client.initialize()
@@ -92,7 +92,7 @@ class BaseConnector(ABC):
         tools_result = await self.client.list_tools()
         self._tools = tools_result.tools
 
-        logger.info(f"MCP session initialized with {len(self._tools)} tools")
+        logger.debug(f"MCP session initialized with {len(self._tools)} tools")
 
         return result
 
@@ -110,6 +110,7 @@ class BaseConnector(ABC):
 
         logger.debug(f"Calling tool '{name}' with arguments: {arguments}")
         result = await self.client.call_tool(name, arguments)
+        logger.debug(f"Tool '{name}' called with result: {result}")
         return result
 
     async def list_resources(self) -> list[dict[str, Any]]:

{mcp_use-1.0.3 → mcp_use-1.1.5}/mcp_use/connectors/http.py

@@ -51,7 +51,7 @@ class HttpConnector(BaseConnector):
             logger.debug("Already connected to MCP implementation")
             return
 
-        logger.info(f"Connecting to MCP implementation via HTTP/SSE: {self.base_url}")
+        logger.debug(f"Connecting to MCP implementation via HTTP/SSE: {self.base_url}")
         try:
             # Create the SSE connection URL
             sse_url = f"{self.base_url}"
@@ -68,7 +68,7 @@ class HttpConnector(BaseConnector):
 
             # Mark as connected
             self._connected = True
-            logger.info(
+            logger.debug(
                 f"Successfully connected to MCP implementation via HTTP/SSE: {self.base_url}"
             )
 

{mcp_use-1.0.3 → mcp_use-1.1.5}/mcp_use/connectors/stdio.py

@@ -49,7 +49,7 @@ class StdioConnector(BaseConnector):
             logger.debug("Already connected to MCP implementation")
             return
 
-        logger.info(f"Connecting to MCP implementation: {self.command}")
+        logger.debug(f"Connecting to MCP implementation: {self.command}")
         try:
             # Create server parameters
             server_params = StdioServerParameters(
@@ -66,7 +66,7 @@ class StdioConnector(BaseConnector):
 
             # Mark as connected
             self._connected = True
-            logger.info(f"Successfully connected to MCP implementation: {self.command}")
+            logger.debug(f"Successfully connected to MCP implementation: {self.command}")
 
         except Exception as e:
             logger.error(f"Failed to connect to MCP implementation: {e}")

{mcp_use-1.0.3 → mcp_use-1.1.5}/mcp_use/connectors/websocket.py

@@ -57,7 +57,7 @@ class WebSocketConnector(BaseConnector):
             logger.debug("Already connected to MCP implementation")
             return
 
-        logger.info(f"Connecting to MCP implementation via WebSocket: {self.url}")
+        logger.debug(f"Connecting to MCP implementation via WebSocket: {self.url}")
         try:
             # Create and start the connection manager
             self._connection_manager = WebSocketConnectionManager(self.url, self.headers)
@@ -70,7 +70,7 @@ class WebSocketConnector(BaseConnector):
 
             # Mark as connected
             self._connected = True
-            logger.info(f"Successfully connected to MCP implementation via WebSocket: {self.url}")
+            logger.debug(f"Successfully connected to MCP implementation via WebSocket: {self.url}")
 
         except Exception as e:
             logger.error(f"Failed to connect to MCP implementation via WebSocket: {e}")
@@ -117,10 +117,10 @@ class WebSocketConnector(BaseConnector):
             logger.debug("Not connected to MCP implementation")
             return
 
-        logger.info("Disconnecting from MCP implementation")
+        logger.debug("Disconnecting from MCP implementation")
         await self._cleanup_resources()
         self._connected = False
-        logger.info("Disconnected from MCP implementation")
+        logger.debug("Disconnected from MCP implementation")
 
     async def _cleanup_resources(self) -> None:
         """Clean up all resources associated with this connector."""
@@ -199,14 +199,14 @@ class WebSocketConnector(BaseConnector):
 
     async def initialize(self) -> dict[str, Any]:
         """Initialize the MCP session and return session information."""
-        logger.info("Initializing MCP session")
+        logger.debug("Initializing MCP session")
         result = await self._send_request("initialize")
 
         # Get available tools
         tools_result = await self.list_tools()
         self._tools = [Tool(**tool) for tool in tools_result]
 
-        logger.info(f"MCP session initialized with {len(self._tools)} tools")
+        logger.debug(f"MCP session initialized with {len(self._tools)} tools")
         return result
 
     async def list_tools(self) -> list[dict[str, Any]]:

{mcp_use-1.0.3 → mcp_use-1.1.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-use"
-version = "1.0.3"
+version = "1.1.5"
 description = "MCP Library for LLMs"
 authors = [
     {name = "Pietro Zullo", email = "pietro.zullo@gmail.com"}

mcp_use-1.0.3/docs/logo/dark.svg

@@ -1,12 +0,0 @@
-<svg viewBox="0 0 200 60" xmlns="http://www.w3.org/2000/svg">
-  <style>
-    .logo-text {
-      font-family: 'Nunito', sans-serif;
-      font-size: 40px;
-      font-weight: 800;
-      fill: #ffffff;
-    }
-  </style>
-  <rect width="100%" height="100%" fill="none"/>
-  <text x="0" y="42" class="logo-text">mcp_use</text>
-</svg>

mcp_use-1.0.3/docs/logo/light.svg

@@ -1,12 +0,0 @@
-<svg viewBox="0 0 200 60" xmlns="http://www.w3.org/2000/svg">
-  <style>
-    .logo-text {
-      font-family: 'Nunito', sans-serif;
-      font-size: 40px;
-      font-weight: 800;
-      fill: #000000;
-    }
-  </style>
-  <rect width="100%" height="100%" fill="none"/>
-  <text x="0" y="42" class="logo-text">mcp_use</text>
-</svg>

mcp_use-1.0.3/docs/quickstart.mdx

@@ -1,138 +0,0 @@
----
-title: Quickstart
-description: "Get started with mcp_use in minutes"
----
-
-# Quickstart Guide
-
-This guide will help you get started with mcp_use quickly. We'll cover installation, basic configuration, and running your first agent.
-
-## Installation
-
-You can install mcp_use using pip:
-
-```bash
-pip install mcp-use
-```
-
-Or install from source:
-
-```bash
-git clone https://github.com/pietrozullo/mcp-use.git
-cd mcp-use
-pip install -e .
-```
-
-## Basic Setup
-
-1. Create a configuration file (e.g., `browser_mcp.json`):
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": ["@playwright/mcp@latest"],
-      "env": {
-        "DISPLAY": ":1"
-      }
-    }
-  }
-}
-```
-
-2. Set up your environment variables in a `.env` file:
-
-```bash
-OPENAI_API_KEY=your_api_key_here
-ANTHROPIC_API_KEY=your_api_key_here
-```
-
-## Your First Agent
-
-Here's a simple example to get you started:
-
-```python
-import asyncio
-import os
-from dotenv import load_dotenv
-from langchain_openai import ChatOpenAI
-from mcp_use import MCPAgent, MCPClient
-
-async def main():
-    # Load environment variables
-    load_dotenv()
-
-    # Create MCPClient from config file
-    client = MCPClient.from_config_file("browser_mcp.json")
-
-    # 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(
-        "Find the best restaurant in San Francisco USING GOOGLE SEARCH",
-    )
-    print(f"\nResult: {result}")
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## Restricting Tool Access
-
-You can control which tools are available to the agent:
-
-```python
-import asyncio
-import os
-from dotenv import load_dotenv
-from langchain_openai import ChatOpenAI
-from mcp_use import MCPAgent, MCPClient
-
-async def main():
-    # Load environment variables
-    load_dotenv()
-
-    # Create MCPClient from config file
-    client = MCPClient.from_config_file("browser_mcp.json")
-
-    # Create LLM
-    llm = ChatOpenAI(model="gpt-4o")
-
-    # Create agent with restricted tools
-    agent = MCPAgent(
-        llm=llm,
-        client=client,
-        max_steps=30,
-        disallowed_tools=["file_system", "network"]  # Restrict potentially dangerous tools
-    )
-
-    # Run the query
-    result = await agent.run(
-        "Find the best restaurant in San Francisco USING GOOGLE SEARCH",
-    )
-    print(f"\nResult: {result}")
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## Available MCP Servers
-
-mcp_use supports various MCP servers:
-
-- **Playwright**: For web browsing and automation
-- **Airbnb**: For property search and booking
-- **Blender**: For 3D modeling and animation
-
-Each server requires its own configuration. Check the [Configuration Guide](/essentials/configuration) for details.
-
-## Next Steps
-
-- Learn about [Configuration Options](/essentials/configuration)
-- Explore [Example Use Cases](/examples)
-- Check out [Advanced Features](/essentials/advanced)