mcp-use 1.2.8__tar.gz → 1.2.9__tar.gz

{mcp_use-1.2.8 → mcp_use-1.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-use
-Version: 1.2.8
+Version: 1.2.9
 Summary: MCP Library for LLMs
 Author-email: Pietro Zullo <pietro.zullo@gmail.com>
 License: MIT
@@ -50,6 +50,7 @@ Description-Content-Type: text/markdown
 [![PyPI Version](https://img.shields.io/pypi/v/mcp_use.svg)](https://pypi.org/project/mcp_use/)
 [![Python Versions](https://img.shields.io/pypi/pyversions/mcp_use.svg)](https://pypi.org/project/mcp_use/)
 [![Documentation](https://img.shields.io/badge/docs-mcp--use.io-blue)](https://docs.mcp-use.io)
+[![Website](https://img.shields.io/badge/website-mcp--use.io-blue)](https://mcp-use.io)
 [![License](https://img.shields.io/github/license/pietrozullo/mcp-use)](https://github.com/pietrozullo/mcp-use/blob/main/LICENSE)
 [![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
 [![GitHub stars](https://img.shields.io/github/stars/pietrozullo/mcp-use?style=social)](https://github.com/pietrozullo/mcp-use/stargazers)
@@ -67,7 +68,8 @@ Description-Content-Type: text/markdown
 |---------|-------------|
 | 🔄 [**Ease of use**](#quick-start) | Create your first MCP capable agent you need only 6 lines of code |
 | 🤖 [**LLM Flexibility**](#installing-langchain-providers) | Works with any langchain supported LLM that supports tool calling (OpenAI, Anthropic, Groq, LLama etc.) |
-| 🌐 [**HTTP Support**](#http-connection-example) | Direct connection to MCP servers running on specific HTTP ports |
+| 🌐 [**Code Builder**](https://mcp-use.io/builder) | Explore MCP capabilities and generate starter code with the interactive [code builder](https://mcp-use.io/builder). |
+| 🔗 [**HTTP Support**](#http-connection-example) | Direct connection to MCP servers running on specific HTTP ports |
 | ⚙️ [**Dynamic Server Selection**](#dynamic-server-selection-server-manager) | Agents can dynamically choose the most appropriate MCP server for a given task from the available pool |
 | 🧩 [**Multi-Server Support**](#multi-server-support) | Use multiple MCP servers simultaneously in a single agent |
 | 🛡️ [**Tool Restrictions**](#tool-access-control) | Restrict potentially dangerous tools like file system or network access |
@@ -184,6 +186,43 @@ Example configuration file (`browser_mcp.json`):
 
 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.
+
+### How to use
+
+Call `agent.astream(query)` and iterate over the results asynchronously:
+
+```python
+async for chunk in agent.astream("Find the best restaurant in San Francisco"):
+    print(chunk["messages"], end="", flush=True)
+```
+
+Each chunk is a dictionary containing keys such as `actions`, `steps`, `messages`, and (on the last chunk) `output`. This enables you to build responsive UIs or log agent progress in real time.
+
+#### Example: Streaming in Practice
+
+```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_dotenv()
+    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."):
+        print(chunk["messages"], end="", flush=True)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+This streaming interface is ideal for applications that require real-time updates, such as chatbots, dashboards, or interactive notebooks.
 
 # Example Use Cases
 
@@ -344,7 +383,7 @@ if __name__ == "__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.
+MCP-Use 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:
 

{mcp_use-1.2.8 → mcp_use-1.2.9}/README.md

@@ -9,6 +9,7 @@
 [![PyPI Version](https://img.shields.io/pypi/v/mcp_use.svg)](https://pypi.org/project/mcp_use/)
 [![Python Versions](https://img.shields.io/pypi/pyversions/mcp_use.svg)](https://pypi.org/project/mcp_use/)
 [![Documentation](https://img.shields.io/badge/docs-mcp--use.io-blue)](https://docs.mcp-use.io)
+[![Website](https://img.shields.io/badge/website-mcp--use.io-blue)](https://mcp-use.io)
 [![License](https://img.shields.io/github/license/pietrozullo/mcp-use)](https://github.com/pietrozullo/mcp-use/blob/main/LICENSE)
 [![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
 [![GitHub stars](https://img.shields.io/github/stars/pietrozullo/mcp-use?style=social)](https://github.com/pietrozullo/mcp-use/stargazers)
@@ -26,7 +27,8 @@
 |---------|-------------|
 | 🔄 [**Ease of use**](#quick-start) | Create your first MCP capable agent you need only 6 lines of code |
 | 🤖 [**LLM Flexibility**](#installing-langchain-providers) | Works with any langchain supported LLM that supports tool calling (OpenAI, Anthropic, Groq, LLama etc.) |
-| 🌐 [**HTTP Support**](#http-connection-example) | Direct connection to MCP servers running on specific HTTP ports |
+| 🌐 [**Code Builder**](https://mcp-use.io/builder) | Explore MCP capabilities and generate starter code with the interactive [code builder](https://mcp-use.io/builder). |
+| 🔗 [**HTTP Support**](#http-connection-example) | Direct connection to MCP servers running on specific HTTP ports |
 | ⚙️ [**Dynamic Server Selection**](#dynamic-server-selection-server-manager) | Agents can dynamically choose the most appropriate MCP server for a given task from the available pool |
 | 🧩 [**Multi-Server Support**](#multi-server-support) | Use multiple MCP servers simultaneously in a single agent |
 | 🛡️ [**Tool Restrictions**](#tool-access-control) | Restrict potentially dangerous tools like file system or network access |
@@ -143,6 +145,43 @@ Example configuration file (`browser_mcp.json`):
 
 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.
+
+### How to use
+
+Call `agent.astream(query)` and iterate over the results asynchronously:
+
+```python
+async for chunk in agent.astream("Find the best restaurant in San Francisco"):
+    print(chunk["messages"], end="", flush=True)
+```
+
+Each chunk is a dictionary containing keys such as `actions`, `steps`, `messages`, and (on the last chunk) `output`. This enables you to build responsive UIs or log agent progress in real time.
+
+#### Example: Streaming in Practice
+
+```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_dotenv()
+    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."):
+        print(chunk["messages"], end="", flush=True)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+This streaming interface is ideal for applications that require real-time updates, such as chatbots, dashboards, or interactive notebooks.
 
 # Example Use Cases
 
@@ -303,7 +342,7 @@ if __name__ == "__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.
+MCP-Use 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:
 

mcp_use-1.2.9/docs/api-reference/mcpagent.mdx

@@ -0,0 +1,21 @@
+## astream
+
+```python
+def astream(
+    query: str,
+    max_steps: int | None = None,
+    manage_connector: bool = True,
+    external_history: list[BaseMessage] | None = None,
+) -> AsyncIterator[dict]:
+```
+
+Asynchronous streaming interface for agent output. Yields incremental results, tool actions, and intermediate steps as they are generated by the agent.
+
+**Example:**
+
+```python
+async for chunk in agent.astream("hello"):
+    print(chunk["messages"], end="|", flush=True)
+```
+
+Each chunk is a dictionary containing keys such as `actions`, `steps`, `messages`, and (on the last chunk) `output`.

{mcp_use-1.2.8 → mcp_use-1.2.9}/docs/development.mdx

@@ -9,7 +9,7 @@ This guide will help you set up your development environment and contribute to m
 
 ## Prerequisites
 
-- Python 3.8 or higher
+- Python 3.11 or higher
 - Git
 - Node.js and npm (for MCP server dependencies)
 
@@ -112,24 +112,3 @@ mcp-use/
 ├── static/           # Static assets
 └── pyproject.toml    # Project configuration
 ```
-
-## Adding New MCP Servers
-
-To add support for a new MCP server:
-
-1. Create a new configuration template in the examples directory
-2. Add necessary server-specific code in the `mcp_use` package
-3. Update documentation with new server information
-4. Add tests for the new server functionality
-
-## Release Process
-
-1. Update version in `pyproject.toml`
-2. Update CHANGELOG.md
-3. Create a new release tag
-4. Build and publish to PyPI:
-
-```bash
-python -m build
-python -m twine upload dist/*
-```

{mcp_use-1.2.8 → mcp_use-1.2.9}/docs/favicon.svg

@@ -1,5 +1,5 @@
 <svg width="303" height="303" viewBox="0 0 303 303" fill="white" xmlns="http://www.w3.org/2000/svg">
-  <rect height="100%" width="100%" rx="55px" fill="white"/>
+  <rect height="100%" width="100%" rx="55px" fill="none"/>
 <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"/>

{mcp_use-1.2.8 → mcp_use-1.2.9}/docs/introduction.mdx

@@ -43,3 +43,20 @@ mcp_use is an open source library that enables developers to connect any Languag
     Learn how to configure mcp_use with your MCP server
   </Card>
 </CardGroup>
+
+## Streaming Agent Output
+
+MCP-Use supports asynchronous streaming of agent output using the `astream` method. This allows you to receive incremental results, tool actions, and intermediate steps as they are generated by the agent.
+
+### How to use
+
+Call `agent.astream(query)` and iterate over the results asynchronously:
+
+```python
+async for chunk in agent.astream("your query here"):
+    print(chunk["messages"], end="", flush=True)
+```
+
+Each chunk is a dictionary containing keys such as `actions`, `steps`, `messages`, and (on the last chunk) `output`. This enables real-time feedback and progress reporting in your applications.
+
+See the README for more details and usage patterns.

{mcp_use-1.2.8 → mcp_use-1.2.9}/docs/quickstart.mdx

@@ -333,6 +333,17 @@ if __name__ == "__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.
 
+## Streaming Agent Output
+
+You can stream the agent's output as it is generated using the `astream` method:
+
+```python
+async for chunk in agent.astream("Find the best restaurant in San Francisco"):
+    print(chunk["messages"], end="", flush=True)
+```
+
+Each chunk contains incremental results, tool actions, and intermediate steps.
+
 ## Next Steps
 
 - Learn about [Configuration Options](/essentials/configuration)

mcp_use-1.2.9/examples/mcp_everything.py

@@ -0,0 +1,41 @@
+"""
+This example shows how to test the different functionalities of MCPs using the MCP server from
+anthropic.
+"""
+
+import asyncio
+
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+
+from mcp_use import MCPAgent, MCPClient
+
+everything_server = {
+    "mcpServers": {
+        "everything": {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-everything"]}
+    }
+}
+
+
+async def main():
+    """Run the example using a configuration file."""
+    load_dotenv()
+    client = MCPClient(config=everything_server)
+    llm = ChatOpenAI(model="gpt-4o", temperature=0)
+    agent = MCPAgent(llm=llm, client=client, max_steps=30)
+
+    result = await agent.run(
+        """
+        Hello, you are a tester can you please answer the follwing questions:
+        - Which resources do you have access to?
+        - Which prompts do you have access to?
+        - Which tools do you have access to?
+        """,
+        max_steps=30,
+    )
+    print(f"\nResult: {result}")
+
+
+if __name__ == "__main__":
+    # Run the appropriate example
+    asyncio.run(main())

{mcp_use-1.2.8 → mcp_use-1.2.9}/mcp_use/agents/mcpagent.py

@@ -6,6 +6,7 @@ to provide a simple interface for using MCP tools with different LLMs.
 """
 
 import logging
+from collections.abc import AsyncIterator
 
 from langchain.agents import AgentExecutor, create_tool_calling_agent
 from langchain.globals import set_debug
@@ -304,6 +305,86 @@ class MCPAgent:
         """
         return self.disallowed_tools
 
+    async def _generate_response_chunks_async(
+        self,
+        query: str,
+        max_steps: int | None = None,
+        manage_connector: bool = True,
+        external_history: list[BaseMessage] | None = None,
+    ) -> AsyncIterator[str]:
+        """Internal async generator yielding response chunks.
+
+        The implementation purposefully keeps the logic compact:
+        1. Ensure the agent is initialised (optionally handling connector
+           lifecycle).
+        2. Forward the *same* inputs we use for ``run`` to LangChain's
+           ``AgentExecutor.astream``.
+        3. Diff the growing ``output`` field coming from LangChain and yield
+           only the new part so the caller receives *incremental* chunks.
+        4. Persist conversation history when memory is enabled.
+        """
+
+        # 1. Initialise on-demand ------------------------------------------------
+        initialised_here = False
+        if (manage_connector and not self._initialized) or (
+            not self._initialized and self.auto_initialize
+        ):
+            await self.initialize()
+            initialised_here = True
+
+        if not self._agent_executor:
+            raise RuntimeError("MCP agent failed to initialise – call initialise() first?")
+
+        # 2. Build inputs --------------------------------------------------------
+        effective_max_steps = max_steps or self.max_steps
+        self._agent_executor.max_iterations = effective_max_steps
+
+        if self.memory_enabled:
+            self.add_to_history(HumanMessage(content=query))
+
+        history_to_use = (
+            external_history if external_history is not None else self._conversation_history
+        )
+        langchain_history: list[BaseMessage] = [
+            m for m in history_to_use if isinstance(m, HumanMessage | AIMessage)
+        ]
+        inputs = {"input": query, "chat_history": langchain_history}
+
+        # 3. Stream & diff -------------------------------------------------------
+        accumulated = ""
+        async for event in self._agent_executor.astream(inputs):
+            yield event
+
+        # 4. Persist assistant message ------------------------------------------
+        if self.memory_enabled and accumulated:
+            self.add_to_history(AIMessage(content=accumulated))
+
+        # 5. House-keeping -------------------------------------------------------
+        if initialised_here and manage_connector:
+            await self.close()
+
+    async def astream(
+        self,
+        query: str,
+        max_steps: int | None = None,
+        manage_connector: bool = True,
+        external_history: list[BaseMessage] | None = None,
+    ) -> AsyncIterator[str]:
+        """Asynchronous streaming interface.
+
+        Example::
+
+            async for chunk in agent.astream("hello"):
+                print(chunk, end="|", flush=True)
+        """
+        async for chunk in self._generate_response_chunks_async(
+            query=query,
+            max_steps=max_steps,
+            manage_connector=manage_connector,
+            external_history=external_history,
+        ):
+            yield chunk
+
     async def run(
         self,
         query: str,

{mcp_use-1.2.8 → mcp_use-1.2.9}/mcp_use/connectors/base.py

@@ -131,6 +131,26 @@ class BaseConnector(ABC):
         resource = await self.client.read_resource(uri)
         return resource.content, resource.mimeType
 
+    async def list_prompts(self) -> list[dict[str, Any]]:
+        """List all available prompts from the MCP implementation."""
+        if not self.client:
+            raise RuntimeError("MCP client is not connected")
+
+        logger.debug("Listing prompts")
+        prompts = await self.client.list_prompts()
+        return prompts
+
+    async def get_prompt(
+        self, name: str, arguments: dict[str, Any] | None = None
+    ) -> tuple[bytes, str]:
+        """Get a prompt by name."""
+        if not self.client:
+            raise RuntimeError("MCP client is not connected")
+
+        logger.debug(f"Getting prompt: {name}")
+        prompt = await self.client.get_prompt(name, arguments)
+        return prompt
+
     async def request(self, method: str, params: dict[str, Any] | None = None) -> Any:
         """Send a raw request to the MCP implementation."""
         if not self.client:

{mcp_use-1.2.8 → mcp_use-1.2.9}/pyproject.toml

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