mcp-use 1.0.3__py3-none-any.whl → 1.1.5__py3-none-any.whl

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/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/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/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/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/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/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.dist-info → mcp_use-1.1.5.dist-info}/METADATA

@@ -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.dist-info → mcp_use-1.1.5.dist-info}/RECORD

@@ -1,24 +1,24 @@
 mcp_use/__init__.py,sha256=PSoxLAu1GPjfIDPcZiJyI3k66MMS3lcfx5kERUgFb1o,723
-mcp_use/client.py,sha256=0rvlJBwvPD19sjDRtXfnp15-F1VHJlXWxLQNt9cHwPA,8275
+mcp_use/client.py,sha256=RoOOpCzMCjpqkkyAIEDOVc6Sn_HsET1rbn_J_J778q4,8278
 mcp_use/config.py,sha256=O9V4pa-shZ2mPokRTrd7KZQ2GpuTcYBGUslefl1fosw,1653
 mcp_use/logging.py,sha256=2-hSB7ZWcHEx_OFHNg8GIbSGCZx3MW4mZGGWxi2Ew3E,2690
 mcp_use/session.py,sha256=Z4EZTUnQUX0QyGMzkJIrMRTX4SDk6qQUoBld408LIJE,3449
 mcp_use/agents/__init__.py,sha256=ukchMTqCOID6ikvLmJ-6sldWTVFIzztGQo4BX6QeQr8,312
 mcp_use/agents/base.py,sha256=bfuldi_89AbSbNc8KeTiCArRT9V62CNxHOWYkLHWjyA,1605
-mcp_use/agents/langchain_agent.py,sha256=5fml081T3meLkZxA8o29eLuMmITyr5EfkKMPGy9UgHA,10165
-mcp_use/agents/mcpagent.py,sha256=YF-ApIGM2lM8mOdeopr-hPlMRuNRNMQpJpg4gm9u6Ns,14183
+mcp_use/agents/langchain_agent.py,sha256=7gHTxZ5kIfHy0qRDMTGKiek0OOlU-7yLd8ruoJPzTyY,10168
+mcp_use/agents/mcpagent.py,sha256=5n0FbLrx30dc1afH75UW2s_R0p3nSssE2BrXYNfbygo,14190
 mcp_use/agents/prompts/default.py,sha256=tnwt9vOiVBhdpu-lIHhwEJo3rvE6EobPfUgS9JURBzg,941
 mcp_use/connectors/__init__.py,sha256=jnd-7pPPJMb0UNJ6aD9lInj5Tlamc8lA_mFyG8RWJpo,385
-mcp_use/connectors/base.py,sha256=TCLVNJdt6qrflmphgXOZhD6xPKQQegbGqe5REmcLYg0,4813
-mcp_use/connectors/http.py,sha256=nkF3hcioYpglwLOTR69WhU8zzLJbZDakgtQ8MsK-cMI,2835
-mcp_use/connectors/stdio.py,sha256=36yEY7hbFXgM7zju5BtLJl4cKAZNCXVRrTaU6YOttBI,2606
-mcp_use/connectors/websocket.py,sha256=4xqxl9UncrfU6NitvKfB80Hk2g7o0Gc0G5sm6sY3RAk,9534
+mcp_use/connectors/base.py,sha256=5TcXB-I5zrwPtedB6dShceNucsK3wHBeGC2yDVq8X48,4885
+mcp_use/connectors/http.py,sha256=2ZG5JxcK1WZ4jkTfTir6bEQLMxXBTPHyi0s42RHGeFs,2837
+mcp_use/connectors/stdio.py,sha256=MTzsqmVVihACUKngE-g5BignK3jAFds2CFv3aSzbJfs,2608
+mcp_use/connectors/websocket.py,sha256=LeU53YI3zjbwKq5GzFRziqA_z9Dn5qACiNyxWDrn2ns,9540
 mcp_use/task_managers/__init__.py,sha256=4dgW5N61iiPLpwjU2rrn_uqrL8mmDJFDaF9Lukzk65A,486
 mcp_use/task_managers/base.py,sha256=ksNdxTwq8N-zqymxVoKGnWXq9iqkLYC61uB91o6Mh-4,4888
 mcp_use/task_managers/sse.py,sha256=WysmjwqRI3meXMZY_F4y9tSBMvSiUZfTJQfitM5l6jQ,2529
 mcp_use/task_managers/stdio.py,sha256=DEISpXv4mo3d5a-WT8lkWbrXJwUh7QW0nMT_IM3fHGg,2269
 mcp_use/task_managers/websocket.py,sha256=ZbCqdGgzCRtsXzRGFws-f2OzH8cPAkN4sJNDwEpRmCc,1915
-mcp_use-1.0.3.dist-info/METADATA,sha256=3HbO5h9azPZyPz6HmK0rWZEB7pdxh4U3jCSEQKtGdtc,11043
-mcp_use-1.0.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mcp_use-1.0.3.dist-info/licenses/LICENSE,sha256=7Pw7dbwJSBw8zH-WE03JnR5uXvitRtaGTP9QWPcexcs,1068
-mcp_use-1.0.3.dist-info/RECORD,,
+mcp_use-1.1.5.dist-info/METADATA,sha256=A-VlMFyFTy0oSs8RpWCEd7cfuo6ObqQrc4O4QdRf67Q,14004
+mcp_use-1.1.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mcp_use-1.1.5.dist-info/licenses/LICENSE,sha256=7Pw7dbwJSBw8zH-WE03JnR5uXvitRtaGTP9QWPcexcs,1068
+mcp_use-1.1.5.dist-info/RECORD,,