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

mcp_use-0.0.5/.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.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
-Name: mcp_use
-Version: 0.0.4
+Name: mcp-use
+Version: 0.0.5
 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/ghibli.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 .
 ```
 

{mcp_use-0.0.4 → mcp_use-0.0.5}/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/ghibli.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 .
 ```
 

{mcp_use-0.0.4 → mcp_use-0.0.5}/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.5}/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.5}/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.5}/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.5/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.5/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.5}/mcp_use/__init__.py

@@ -5,6 +5,8 @@ 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
@@ -12,7 +14,8 @@ from .connectors import BaseConnector, HttpConnector, StdioConnector, WebSocketC
 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.5}/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.4 → mcp_use-0.0.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
-name = "mcp_use"
-version = "0.0.4"
+name = "mcp-use"
+version = "0.0.5"
 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 }}