mcp-use 0.0.4__py3-none-any.whl → 0.0.6__py3-none-any.whl

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/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/agents/prompts/default.py

@@ -3,9 +3,20 @@ DEFAULT_SYSTEM_PROMPT_TEMPLATE = """You are an assistant with access to these to
 {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
+- 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
 
-You CAN access current information using your tools. Never claim you lack access to real-time data.
+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/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.dist-info → mcp_use-0.0.6.dist-info}/METADATA

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

@@ -1,13 +1,13 @@
-mcp_use/__init__.py,sha256=wH2KewPklX8TjKnuECJhUCPL6BqOngmFjTtpleKi46s,699
+mcp_use/__init__.py,sha256=PSoxLAu1GPjfIDPcZiJyI3k66MMS3lcfx5kERUgFb1o,723
 mcp_use/client.py,sha256=7dBjkRPqyUlp-8NuLcYbW-4ctLDp329DsAvRM1HlVus,7807
-mcp_use/config.py,sha256=ZoOdKX6qVR5SD7PfO-iqzKxXOb4NMcnpHpZquGgMas4,2578
+mcp_use/config.py,sha256=D9LuCuT1mFUSBiO2DUGa5Pnd-yjNcvM9u_v11N5UmK8,1624
 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=RaQEo-tm3b4SBeu3DxE9YYdTuTAHBqEd5vSZ6Qi3g5Q,10320
-mcp_use/agents/mcpagent.py,sha256=87NwMYr4gnAj-fEntAPo7AWbHI60JvnJM5dLIbls-i0,12260
-mcp_use/agents/prompts/default.py,sha256=msFRqH5ZPlcpVh5lzT9Bq5gu5m9wH819KO-xYiFs01g,392
+mcp_use/agents/mcpagent.py,sha256=0iDbqmzKtj0k1Ge8bsddiwgNEN-YAUdpLItB7ldLYrE,12444
+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=caUaTfsODUOik8JF9mPtcZDyZhoIz2X12I_BhAfZK10,1616
 mcp_use/connectors/http.py,sha256=KqVf0HXouFoeQ_bBUr6KQifiUjTo7K6EOCRkqVpFx4Q,7763
@@ -18,7 +18,7 @@ mcp_use/task_managers/base.py,sha256=ksNdxTwq8N-zqymxVoKGnWXq9iqkLYC61uB91o6Mh-4
 mcp_use/task_managers/http.py,sha256=XhrF73RGRnVctBVW2FlFrFTJR2pIGXhtNvfJFiW0Olw,1881
 mcp_use/task_managers/stdio.py,sha256=DEISpXv4mo3d5a-WT8lkWbrXJwUh7QW0nMT_IM3fHGg,2269
 mcp_use/task_managers/websocket.py,sha256=SVgTLFogiynb48eyi6ZioWIKLLWiVBCNE59rXi6GrCM,1943
-mcp_use-0.0.4.dist-info/METADATA,sha256=A63pM3FRoTjjjQl9zDGgUSls-_vX6N7Du4o5VfeuqXY,9141
-mcp_use-0.0.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mcp_use-0.0.4.dist-info/licenses/LICENSE,sha256=7Pw7dbwJSBw8zH-WE03JnR5uXvitRtaGTP9QWPcexcs,1068
-mcp_use-0.0.4.dist-info/RECORD,,
+mcp_use-0.0.6.dist-info/METADATA,sha256=o4EFi3L21-zAhNssvaRK0y1HFz95FOJYKAHzqXanhIw,8528
+mcp_use-0.0.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mcp_use-0.0.6.dist-info/licenses/LICENSE,sha256=7Pw7dbwJSBw8zH-WE03JnR5uXvitRtaGTP9QWPcexcs,1068
+mcp_use-0.0.6.dist-info/RECORD,,