mcp-use 0.0.4__tar.gz → 0.0.6__tar.gz

mcp_use-0.0.6/.github/workflows/publish.yml

@@ -0,0 +1,78 @@
+name: Check Version Bump and Publish to PyPI
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'pyproject.toml'
+
+# Required for PyPI trusted publishing
+permissions:
+  id-token: write
+  contents: write  # Required for creating tags and releases
+
+jobs:
+  check-version-and-publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0  # This fetches all history for comparing versions
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine wheel tomli
+
+      - name: Check for version bump
+        id: check-version
+        run: |
+          # Extract current version directly from pyproject.toml
+          # This is more reliable than using importlib.metadata
+          CURRENT_VERSION=$(python -c "
+          import tomli
+          with open('pyproject.toml', 'rb') as f:
+              data = tomli.load(f)
+          print(data['project']['version'])
+                    ")
+
+          echo "Current version: $CURRENT_VERSION"
+
+          # Check if this version already has a tag
+          if git rev-parse "v$CURRENT_VERSION" >/dev/null 2>&1; then
+            echo "Version $CURRENT_VERSION already has a tag. Skipping release."
+            echo "is_new_version=false" >> $GITHUB_OUTPUT
+          else
+            echo "New version detected: $CURRENT_VERSION"
+            echo "is_new_version=true" >> $GITHUB_OUTPUT
+            echo "new_version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Build package
+        if: steps.check-version.outputs.is_new_version == 'true'
+        run: |
+          python -m build
+
+      - name: Create Release
+        if: steps.check-version.outputs.is_new_version == 'true'
+        id: create_release
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: v${{ steps.check-version.outputs.new_version }}
+          release_name: Release v${{ steps.check-version.outputs.new_version }}
+          draft: false
+          prerelease: false
+
+      - name: Publish to PyPI
+        if: steps.check-version.outputs.is_new_version == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

{mcp_use-0.0.4 → mcp_use-0.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
-Name: mcp_use
-Version: 0.0.4
+Name: mcp-use
+Version: 0.0.6
 Summary: MCP Library for LLMs
 Author-email: Pietro Zullo <pietro.zullo@gmail.com>
 License: MIT
@@ -38,16 +38,20 @@ Requires-Dist: openai>=1.10.0; extra == 'openai'
 Description-Content-Type: text/markdown
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./static/mcp-use-dark.png">
-  <source media="(prefers-color-scheme: light)" srcset="./static/mcp-use.png">
-  <img alt="Shows a black MCP-Use Logo in light color mode and a white one in dark color mode." src="./static/mcp-use.png"  width="full">
+  <img alt="" src="./static/mcpusegrass.png"  width="full">
 </picture>
 
-<h1 align="center">Use MCPs directly from python 🤖</h1>
+<h1 align="center">Open Source MCP CLient Library </h1>
 
+[![](https://img.shields.io/pypi/dd/mcp_use.svg)](https://pypi.org/project/mcp_use/)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/mcp_use.svg)](https://pypi.org/project/mcp_use/)
+[![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/)
+[![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)
 
-🌐 MCP-Use is the easiest way to connect any LLM to MCP tools through a unified interface without using closed source or application clients.
+🌐 MCP-Use is the open source way to connect any LLM to MCP tools and build custom agents that have tool access, without using closed source or application clients.
 
 💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
 
@@ -56,14 +60,14 @@ Description-Content-Type: text/markdown
 With pip:
 
 ```bash
-pip install mcp_use
+pip install mcp-use
 ```
 
 Or install from source:
 
 ```bash
-git clone https://github.com/pietrozullo/mcp_use.git
-cd mcp_use
+git clone https://github.com/pietrozullo/mcp-use.git
+cd mcp-use
 pip install -e .
 ```
 
@@ -281,51 +285,12 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
-# MCPClient for Managing Multiple Servers
-
-The `MCPClient` class provides a higher-level abstraction for managing multiple MCP servers from a single client:
-
-```python
-import asyncio
-from langchain_anthropic import ChatAnthropic
-from mcp_use import MCPAgent, MCPClient
-
-async def main():
-    # Create a client from a config file
-    client = MCPClient.from_config_file("mcp-config.json")
-
-    # Or initialize with a config file path
-    # client = MCPClient("mcp-config.json")
-
-    # Or programmatically add servers
-    client.add_server(
-        "local-ws",
-        {
-            "command": "npx",
-            "args": ["@playwright/mcp@latest", "headless"]
-        }
-    )
-
-    # Create an LLM
-    llm = ChatAnthropic(model="claude-3-5-sonnet-20240620")
-
-    # Create an agent using the client
-    agent = MCPAgent(
-        llm=llm,
-        client=client,
-        server_name="playwright",  # Optional, uses first server if not specified
-        max_steps=30
-    )
-
-    # Run a query
-    result = await agent.run("Your query here")
-
-    # Close all sessions
-    await client.close_all_sessions()
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
+## Roadmap
+<ul>
+<li>[ ] Multiple Servers at once </li>
+<li>[ ] Test remote connectors (http, ws)</li>
+<li>[ ] ... </li>
+</ul>
 
 ## Contributing
 
@@ -342,10 +307,10 @@ We love contributions! Feel free to open issues for bugs or feature requests.
 If you use MCP-Use in your research or project, please cite:
 
 ```bibtex
-@software{mcp_use2024,
+@software{mcp_use2025,
   author = {Zullo, Pietro},
   title = {MCP-Use: MCP Library for Python},
-  year = {2024},
+  year = {2025},
   publisher = {GitHub},
   url = {https://github.com/pietrozullo/mcp-use}
 }

{mcp_use-0.0.4 → mcp_use-0.0.6}/README.md

@@ -1,14 +1,18 @@
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./static/mcp-use-dark.png">
-  <source media="(prefers-color-scheme: light)" srcset="./static/mcp-use.png">
-  <img alt="Shows a black MCP-Use Logo in light color mode and a white one in dark color mode." src="./static/mcp-use.png"  width="full">
+  <img alt="" src="./static/mcpusegrass.png"  width="full">
 </picture>
 
-<h1 align="center">Use MCPs directly from python 🤖</h1>
+<h1 align="center">Open Source MCP CLient Library </h1>
 
+[![](https://img.shields.io/pypi/dd/mcp_use.svg)](https://pypi.org/project/mcp_use/)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/mcp_use.svg)](https://pypi.org/project/mcp_use/)
+[![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/)
+[![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)
 
-🌐 MCP-Use is the easiest way to connect any LLM to MCP tools through a unified interface without using closed source or application clients.
+🌐 MCP-Use is the open source way to connect any LLM to MCP tools and build custom agents that have tool access, without using closed source or application clients.
 
 💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
 
@@ -17,14 +21,14 @@
 With pip:
 
 ```bash
-pip install mcp_use
+pip install mcp-use
 ```
 
 Or install from source:
 
 ```bash
-git clone https://github.com/pietrozullo/mcp_use.git
-cd mcp_use
+git clone https://github.com/pietrozullo/mcp-use.git
+cd mcp-use
 pip install -e .
 ```
 
@@ -242,51 +246,12 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
-# MCPClient for Managing Multiple Servers
-
-The `MCPClient` class provides a higher-level abstraction for managing multiple MCP servers from a single client:
-
-```python
-import asyncio
-from langchain_anthropic import ChatAnthropic
-from mcp_use import MCPAgent, MCPClient
-
-async def main():
-    # Create a client from a config file
-    client = MCPClient.from_config_file("mcp-config.json")
-
-    # Or initialize with a config file path
-    # client = MCPClient("mcp-config.json")
-
-    # Or programmatically add servers
-    client.add_server(
-        "local-ws",
-        {
-            "command": "npx",
-            "args": ["@playwright/mcp@latest", "headless"]
-        }
-    )
-
-    # Create an LLM
-    llm = ChatAnthropic(model="claude-3-5-sonnet-20240620")
-
-    # Create an agent using the client
-    agent = MCPAgent(
-        llm=llm,
-        client=client,
-        server_name="playwright",  # Optional, uses first server if not specified
-        max_steps=30
-    )
-
-    # Run a query
-    result = await agent.run("Your query here")
-
-    # Close all sessions
-    await client.close_all_sessions()
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
+## Roadmap
+<ul>
+<li>[ ] Multiple Servers at once </li>
+<li>[ ] Test remote connectors (http, ws)</li>
+<li>[ ] ... </li>
+</ul>
 
 ## Contributing
 
@@ -303,10 +268,10 @@ We love contributions! Feel free to open issues for bugs or feature requests.
 If you use MCP-Use in your research or project, please cite:
 
 ```bibtex
-@software{mcp_use2024,
+@software{mcp_use2025,
   author = {Zullo, Pietro},
   title = {MCP-Use: MCP Library for Python},
-  year = {2024},
+  year = {2025},
   publisher = {GitHub},
   url = {https://github.com/pietrozullo/mcp-use}
 }

{mcp_use-0.0.4 → mcp_use-0.0.6}/examples/airbnb_mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
       "airbnb": {
           "command": "npx",
-          "args": ["-y", "@openbnb/mcp-server-airbnb"]
+          "args": ["-y", "@openbnb/mcp-server-airbnb", "--ignore-robots-txt"]
       }
   }
 }

{mcp_use-0.0.4 → mcp_use-0.0.6}/examples/airbnb_use.py

@@ -3,6 +3,8 @@ Example demonstrating how to use mcp_use with Airbnb.
 
 This example shows how to connect an LLM to Airbnb through MCP tools
 to perform tasks like searching for accommodations.
+
+Special Thanks to https://github.com/openbnb-org/mcp-server-airbnb for the server.
 """
 
 import asyncio

{mcp_use-0.0.4 → mcp_use-0.0.6}/examples/blender_use.py

@@ -4,10 +4,12 @@ Blender MCP example for mcp_use.
 This example demonstrates how to use the mcp_use library with MCPClient
 to connect an LLM to Blender through MCP tools via WebSocket.
 The example assumes you have installed the Blender MCP addon from:
-https://github.com/gd3kr/BlenderGPT/tree/main/mcp_addon
+https://github.com/ahujasid/blender-mcp
 
 Make sure the addon is enabled in Blender preferences and the WebSocket
 server is running before executing this script.
+
+Special thanks to https://github.com/ahujasid/blender-mcp for the server.
 """
 
 import asyncio

{mcp_use-0.0.4 → mcp_use-0.0.6}/examples/browser_use.py

@@ -3,6 +3,8 @@ Basic usage example for mcp_use.
 
 This example demonstrates how to use the mcp_use library with MCPClient
 to connect any LLM to MCP tools through a unified interface.
+
+Special thanks to https://github.com/microsoft/playwright-mcp for the server.
 """
 
 import asyncio

mcp_use-0.0.4/examples/chat_examle.py → mcp_use-0.0.6/examples/chat_example.py

@@ -3,6 +3,8 @@ Simple chat example using MCPAgent with built-in conversation memory.
 
 This example demonstrates how to use the MCPAgent with its built-in
 conversation history capabilities for better contextual interactions.
+
+Special thanks to https://github.com/microsoft/playwright-mcp for the server.
 """
 
 import asyncio

mcp_use-0.0.6/examples/filesystem_use.py

@@ -0,0 +1,58 @@
+"""
+Basic usage example for mcp_use.
+
+This example demonstrates how to use the mcp_use library with MCPClient
+to connect any LLM to MCP tools through a unified interface.
+
+Special Thanks to https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem
+for the server.
+"""
+
+import asyncio
+
+from dotenv import load_dotenv
+from langchain_openai import ChatOpenAI
+
+from mcp_use import MCPAgent, MCPClient
+
+config = {
+    "mcpServers": {
+        "filesystem": {
+            "command": "npx",
+            "args": [
+                "-y",
+                "@modelcontextprotocol/server-filesystem",
+                "/home/pietro/projects/mcp-use/",
+            ],
+        }
+    }
+}
+
+
+async def main():
+    """Run the example using a configuration file."""
+    # Load environment variables
+    load_dotenv()
+
+    # Create MCPClient from config file
+    client = MCPClient.from_dict(config)
+    # Create LLM
+    llm = ChatOpenAI(model="gpt-4o")
+    # llm = init_chat_model(model="llama-3.1-8b-instant", model_provider="groq")
+    # llm = ChatAnthropic(model="claude-3-")
+    # llm = ChatGroq(model="llama3-8b-8192")
+
+    # Create agent with the client
+    agent = MCPAgent(llm=llm, client=client, max_steps=30)
+
+    # Run the query
+    result = await agent.run(
+        "Hello can you give me a list of files and directories in the current directory",
+        max_steps=30,
+    )
+    print(f"\nResult: {result}")
+
+
+if __name__ == "__main__":
+    # Run the appropriate example
+    asyncio.run(main())

{mcp_use-0.0.4 → mcp_use-0.0.6}/mcp_use/__init__.py

@@ -5,14 +5,17 @@ This library provides a unified interface for connecting different LLMs
 to MCP tools through existing LangChain adapters.
 """
 
+from importlib.metadata import version
+
 from .agents.mcpagent import MCPAgent
 from .client import MCPClient
-from .config import create_session_from_config, load_config_file
+from .config import load_config_file
 from .connectors import BaseConnector, HttpConnector, StdioConnector, WebSocketConnector
 from .logging import logger
 from .session import MCPSession
 
-__version__ = "0.0.3"
+__version__ = version("mcp-use")
+
 __all__ = [
     "MCPAgent",
     "MCPClient",

{mcp_use-0.0.4 → mcp_use-0.0.6}/mcp_use/agents/mcpagent.py

@@ -124,7 +124,9 @@ class MCPAgent:
         # Generate tool descriptions
         tool_descriptions = []
         for tool in tools:
-            description = f"- {tool.name}: {tool.description}"
+            # Escape curly braces in the description by doubling them
+            # (sometimes e.g. blender mcp they are used in the description)
+            description = f"- {tool.name}: {tool.description.replace('{', '{{').replace('}', '}}')}"
             tool_descriptions.append(description)
 
         # Format the system prompt template with tool descriptions

mcp_use-0.0.6/mcp_use/agents/prompts/default.py

@@ -0,0 +1,22 @@
+DEFAULT_SYSTEM_PROMPT_TEMPLATE = """You are an assistant with access to these tools:
+
+{tool_descriptions}
+
+Proactively use these tools to:
+- Retrieve and analyze information relevant to user requests
+- Process and transform data in various formats
+- Perform computations and generate insights
+- Execute multi-step workflows by combining tools as needed
+- Interact with external systems when authorized
+
+When appropriate, use available tools rather than relying on your built-in knowledge alone.
+Your tools enable you to perform tasks that would otherwise be beyond your capabilities.
+
+For optimal assistance:
+1. Identify when a tool can help address the user's request
+2. Select the most appropriate tool(s) for the task
+3. Apply tools in the correct sequence when multiple tools are needed
+4. Clearly communicate your process and findings
+
+Remember that you have real capabilities through your tools - use them confidently when needed.
+"""

{mcp_use-0.0.4 → mcp_use-0.0.6}/mcp_use/config.py

@@ -8,7 +8,6 @@ import json
 from typing import Any
 
 from .connectors import BaseConnector, HttpConnector, StdioConnector, WebSocketConnector
-from .session import MCPSession
 
 
 def load_config_file(filepath: str) -> dict[str, Any]:
@@ -58,36 +57,3 @@ def create_connector_from_config(server_config: dict[str, Any]) -> BaseConnector
         )
 
     raise ValueError("Cannot determine connector type from config")
-
-
-def create_session_from_config(
-    filepath: str,
-    server_name: str | None = None,
-) -> MCPSession:
-    """Create an MCPSession from a configuration file.
-
-    Args:
-        filepath: Path to the configuration file
-        server_name: Name of the server to use from config, uses first if None
-
-    Returns:
-        Configured MCPSession instance
-    """
-    config = load_config_file(filepath)
-
-    # Get server config
-    servers = config.get("mcpServers", {})
-    if not servers:
-        raise ValueError("No MCP servers defined in config")
-
-    # If server_name not specified, use the first one
-    if not server_name:
-        server_name = next(iter(servers.keys()))
-
-    if server_name not in servers:
-        raise ValueError(f"Server '{server_name}' not found in config")
-
-    server_config = servers[server_name]
-    connector = create_connector_from_config(server_config)
-
-    return MCPSession(connector)

{mcp_use-0.0.4 → mcp_use-0.0.6}/pyproject.toml

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

mcp_use-0.0.4/.github/workflows/publish.yml

@@ -1,31 +0,0 @@
-name: Publish to PyPI
-
-on:
-  release:
-    types: [created]
-
-# Required for PyPI trusted publishing
-permissions:
-  id-token: write
-  contents: read
-
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - name: Set up Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: "3.11"
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install build twine wheel
-      - name: Build package
-        run: |
-          python -m build
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          password: ${{ secrets.PYPI_API_TOKEN }}

mcp_use-0.0.4/mcp_use/agents/prompts/default.py

@@ -1,11 +0,0 @@
-DEFAULT_SYSTEM_PROMPT_TEMPLATE = """You are an assistant with access to these tools:
-
-{tool_descriptions}
-
-Proactively use these tools to:
-- Find real-time information (weather, news, prices)
-- Perform web searches and extract relevant data
-- Execute multi-step tasks by combining tools
-
-You CAN access current information using your tools. Never claim you lack access to real-time data.
-"""